@@ -42,6 +42,7 @@ var (
 	ssoAddCmd = &cobra.Command{
 		Use:     "add",
 		Short:   "Add a new SSO identity provider",
+		Long:    "Add and configure a new connection to a SSO identity provider to your Supabase project.",
 		Example: `  supabase sso add --type saml --project-ref mwjylndxudmiehsxhmmz --metadata-url 'https://...' --domains example.com`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return create.Run(cmd.Context(), create.RunParams{
@@ -60,6 +61,7 @@ var (
 	ssoRemoveCmd = &cobra.Command{
 		Use:     "remove <provider-id>",
 		Short:   "Remove an existing SSO identity provider",
+		Long:    "Remove a connection to an already added SSO identity provider. Removing the provider will prevent existing users from logging in. Please treat this command with care.",
 		Args:    cobra.ExactArgs(1),
 		Example: `  supabase sso remove b5ae62f9-ef1d-4f11-a02b-731c8bbb11e8 --project-ref mwjylndxudmiehsxhmmz`,
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -74,6 +76,7 @@ var (
 	ssoUpdateCmd = &cobra.Command{
 		Use:     "update <provider-id>",
 		Short:   "Update information about an SSO identity provider",
+		Long:    "Update the configuration settings of a already added SSO identity provider.",
 		Args:    cobra.ExactArgs(1),
 		Example: `  supabase sso update b5ae62f9-ef1d-4f11-a02b-731c8bbb11e8 --project-ref mwjylndxudmiehsxhmmz --add-domains example.com`,
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -100,6 +103,7 @@ var (
 	ssoShowCmd = &cobra.Command{
 		Use:     "show <provider-id>",
 		Short:   "Show information about an SSO identity provider",
+		Long:    "Provides the information about an established connection to an identity provider. You can use --metadata to obtain the raw SAML 2.0 Metadata XML document stored in your project's configuration.",
 		Args:    cobra.ExactArgs(1),
 		Example: `  supabase sso show b5ae62f9-ef1d-4f11-a02b-731c8bbb11e8 --project-ref mwjylndxudmiehsxhmmz`,
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -119,6 +123,7 @@ var (
 	ssoListCmd = &cobra.Command{
 		Use:     "list",
 		Short:   "List all SSO identity providers for a project",
+		Long:    "List all connections to a SSO identity provider to your Supabase project.",
 		Example: `  supabase sso list --project-ref mwjylndxudmiehsxhmmz`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return list.Run(cmd.Context(), flags.ProjectRef, ssoOutput.Value)
@@ -128,6 +133,7 @@ var (
 	ssoInfoCmd = &cobra.Command{
 		Use:     "info",
 		Short:   "Returns the SAML SSO settings required for the identity provider",
+		Long:    "Returns all of the important SSO information necessary for your project to be registered with a SAML 2.0 compatible identity provider.",
 		Example: `  supabase sso info --project-ref mwjylndxudmiehsxhmmz`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return info.Run(cmd.Context(), flags.ProjectRef, ssoOutput.Value)
 
@@ -1,6 +1,6 @@
 ## supabase-login
 
-Connect the Supabase CLI to your Supabase account by logging in with your [personal access token](https://app.supabase.com/account/tokens).
+Connect the Supabase CLI to your Supabase account by logging in with your [personal access token](https://supabase.com/dashboard/account/tokens).
 
 Your access token is stored securely in [native credentials storage](https://github.com/zalando/go-keyring#dependencies). If native credentials storage is unavailable, it will be written to a plain text file at `~/.supabase/access-token`.
 
 
@@ -12,7 +12,7 @@ supabase-login:
     name: Basic usage
     code: supabase login
     response: |
-      You can generate an access token from https://app.supabase.com/account/tokens
+      You can generate an access token from https://supabase.com/dashboard/account/tokens
       Enter your access token: sbp_****************************************
       Finished supabase login.
 supabase-link:
@@ -263,3 +263,87 @@ supabase-test-db:
       All tests successful.
       Files=2, Tests=2,  6 wallclock secs ( 0.03 usr  0.01 sys +  0.05 cusr  0.02 csys =  0.11 CPU)
       Result: PASS
+# TODO: use actual cli response for sso commands
+supabase-sso-show:
+  - id: basic-usage
+    name: Show information
+    code: |-
+      supabase sso show 6df4d73f-bf21-405f-a084-b11adf19fea5 \
+        --project-ref abcdefghijklmnopqrst
+    response: |-
+      Information about the identity provider in pretty output.
+  - id: metadata-output
+    name: Get raw SAML 2.0 Metadata XML
+    code: |-
+      supabase sso show 6df4d73f-bf21-405f-a084-b11adf19fea5 \
+        --project-ref abcdefghijklmnopqrst \
+        --metadata
+    response: |-
+      Raw SAML 2.0 XML assigned to this identity provider. This is the
+      version used in the authentication project, and if using a SAML 2.0
+      Metadata URL it may change depending on the caching information
+      contained within the metadata.
+supabase-sso-update:
+  - id: basic-usage
+    name: Replace domains
+    code: |-
+      supabase sso update 6df4d73f-bf21-405f-a084-b11adf19fea5 \
+        --project-ref abcdefghijklmnopqrst \
+        --domains new-company.com,new-company.net
+    response: |-
+      Information about the updated provider.
+  - id: add-domains
+    name: Add an additional domain
+    code: |-
+      supabase sso update 6df4d73f-bf21-405f-a084-b11adf19fea5 \
+        --project-ref abcdefghijklmnopqrst \
+        --add-domains company.net
+    response: |-
+      Information about the updated provider.
+  - id: remove-domains
+    name: Remove a domain
+    code: |-
+      supabase sso update 6df4d73f-bf21-405f-a084-b11adf19fea5 \
+        --project-ref abcdefghijklmnopqrst \
+        --remove-domains company.org
+    response: |-
+      Information about the updated provider.
+supabase-sso-remove:
+  - id: basic-usage
+    name: Remove a provider
+    code: |-
+      supabase sso remove 6df4d73f-bf21-405f-a084-b11adf19fea5 \
+        --project-ref abcdefghijklmnopqrst
+    response: |-
+      Information about the removed identity provider. It's a good idea to
+      save this in case you need it later on.
+supabase-sso-add:
+  - id: basic-usage
+    name: Add with Metadata URL
+    code: |-
+      supabase sso add \
+        --project-ref abcdefgijklmnopqrst \
+        --type saml \
+        --metadata-url 'https://...' \
+        --domains company.com
+    response: |-
+      Information about the added identity provider. You can use
+      company.com as the domain name on the frontend side to initiate a SSO
+      request to the identity provider.
+  - id: with-xml
+    name: Add with Metadata File
+    code: |-
+      supabase sso add \
+        --project-ref abcdefgijklmnopqrst \
+        --type saml \
+        --metadata-file /path/to/metadata/file.xml \
+        --domains company.com
+    response: |-
+      Information about the added identity provider. You can use
+      company.com as the domain name on the frontend side to initiate a SSO
+      request to the identity provider.
+supabase-sso-info:
+  - id: basic-usage
+    name: Show project information
+    code: supabase sso info --project-ref abcdefghijklmnopqrst
+    response: Information about your project's SAML 2.0 configuration.
@@ -277,7 +277,7 @@ func GetSupabaseAPIHost() string {
 func GetSupabaseDashboardURL() string {
 	switch GetSupabaseAPIHost() {
 	case DefaultApiHost, DeprecatedApiHost:
-		return "https://app.supabase.com"
+		return "https://supabase.com/dashboard"
 	case "https://api.supabase.green":
 		return "https://app.supabase.green"
 	default: