coder
diff --git a/‎ci/integration/secrets_test.go
+1 b/‎ci/integration/secrets_test.go
+1
diff --git a/‎docs/coder.md
-1 b/‎docs/coder.md
-1
diff --git a/‎docs/coder_secrets.md
-29 b/‎docs/coder_secrets.md
-29
diff --git a/‎docs/coder_secrets_create.md
-41 b/‎docs/coder_secrets_create.md
-41
diff --git a/‎docs/coder_secrets_ls.md
-25 b/‎docs/coder_secrets_ls.md
-25
diff --git a/‎docs/coder_secrets_rm.md
-31 b/‎docs/coder_secrets_rm.md
-31
diff --git a/‎docs/coder_secrets_view.md
-31 b/‎docs/coder_secrets_view.md
-31
diff --git a/‎internal/cmd/secrets.go
+13-3 b/‎internal/cmd/secrets.go
+13-3
@@ -12,6 +12,7 @@ import (
 func TestSecrets(t *testing.T) {
 	t.Parallel()
 	run(t, "secrets-cli-tests", func(t *testing.T, ctx context.Context, c *tcli.ContainerRunner) {
+		t.Skip()
 		headlessLogin(ctx, t, c)
 
 		c.Run(ctx, "coder secrets ls").Assert(t,
 
@@ -16,7 +16,6 @@ coder provides a CLI for working with an existing Coder Enterprise installation
 * [coder envs](coder_envs.md)	 - Interact with Coder environments
 * [coder login](coder_login.md)	 - Authenticate this client for future operations
 * [coder logout](coder_logout.md)	 - Remove local authentication credentials if any exist
-* [coder secrets](coder_secrets.md)	 - Interact with Coder Secrets
 * [coder sh](coder_sh.md)	 - Open a shell and execute commands in a Coder environment
 * [coder sync](coder_sync.md)	 - Establish a one way directory sync to a Coder environment
 * [coder urls](coder_urls.md)	 - Interact with environment DevURLs
 
@@ -17,9 +17,19 @@ import (
 func secretsCmd() *cobra.Command {
 	var user string
 	cmd := &cobra.Command{
-		Use:   "secrets",
-		Short: "Interact with Coder Secrets",
-		Long:  "Interact with secrets objects owned by the active user.",
+		Use:    "secrets",
+		Short:  "Interact with Coder Secrets",
+		Long:   "Interact with secrets objects owned by the active user.",
+		Hidden: true,
+		PersistentPreRun: func(cmd *cobra.Command, args []string) {
+			clog.LogWarn(
+				"The 'secrets' command is now deprecated",
+				"It will be removed in the next minor release",
+			)
+		},
+		Run: func(cmd *cobra.Command, args []string) {
+			_ = cmd.Help()
+		},
 	}
 	cmd.PersistentFlags().StringVar(&user, "user", coder.Me, "Specify the user whose resources to target")
 	cmd.AddCommand(