Skip to content

feat(claude): hide and deprecate depot claude (DEP-8856) - #708

Merged
121watts merged 2 commits into
mainfrom
watts/dep-8856-remove-deprecated-remote-agents-claude-from
Nov 18, 2026
Merged

121watts merged 2 commits into
mainfrom
watts/dep-8856-remove-deprecated-remote-agents-claude-from

Conversation

@121watts

@121watts 121watts commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

depot claude takes a quiet bow: gone from help and completion, still works, and tells you where to go next.

What was happening

Remote Agents (Claude) is deprecated in favor of Depot Managed Agents, but depot --help and shell completion still advertised depot claude with no hint of that.

What happens now

The command is Hidden and prints one line to stderr at the start of its RunE, then runs as before:

depot claude is deprecated; use Depot Managed Agents instead: https://depot.dev/docs/managed-agents/claude-code-self-hosted

Before/after with built binaries:

before after
depot --help | grep -i claude claude Run claude with automatic session persistence (nothing)
depot __complete "" lists claude no claude
depot claude --help stderr help text notice line, then the same help text
depot claude list-sessions --help stdout md5 c5c441c6… md5 c5c441c6… (identical)
depot claude --help stdout md5 07e67c81… md5 07e67c81… (identical)
depot claude secrets stdout md5 1d1b31ed… md5 1d1b31ed… (identical)

It writes to cmd.ErrOrStderr() instead of using cobra's Deprecated, because Deprecated prints via OutOrStderr(), which is docker's stdout when depot runs as a Docker CLI plugin (docker depot claude … --output json). It prints on list-sessions and secrets too, since those dispatch through the claude command's RunE.

Anything else?

This hides and warns instead of removing the command (what the ticket asks). 16 external orgs ran depot claude this month, and the API boots every Remote Agent sandbox by running depot claude --org … --token … --session-id … inside it, so deleting it would break customers and our own sandboxes on the next base-image bump. Full removal waits until the server stops calling depot claude.

Fixes DEP-8856

🤖 Generated with Claude Code


Note

Low Risk
Visibility and messaging only; command execution and stdout output paths are preserved and covered by tests.

Overview
depot claude is hidden from public help and shell completion but remains registered and behaviorally unchanged for callers that invoke it directly (including existing sandboxes).

On every run, the command prints a custom deprecation line to stderr pointing users to Depot Managed Agents, deliberately not using Cobra’s Deprecated field so the notice does not land on stdout when the CLI runs as a Docker plugin.

A new root test asserts claude is absent from --help and completion, still discoverable via Find, and that the deprecation message appears only on stderr (stdout stays clean for scripted output).

Reviewed by Cursor Bugbot for commit c85174d. Bugbot is set up for automated code reviews on this repo. Configure here.

Remote Agents is deprecated in favor of Depot Managed Agents. Hide the
command from help and completion and print a deprecation notice on
stderr. The command keeps working: customers still use it and the API
boots every Remote Agent sandbox with `depot claude`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@linear-code

linear-code Bot commented Nov 18, 2026

Copy link
Copy Markdown

DEP-8856

@121watts
121watts marked this pull request as ready for review November 18, 2026 17:27

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note

🤖 Cursor Grok 4.6 responding on behalf of the Cursor Approval Agent

Risk: low. Approved after Cursor Bugbot passed with no findings that need human review. The change only hides and deprecates depot claude while leaving the command registered and executable.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Router and Approver

@claude claude Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nothing blocking. The comments below are optional suggestions. There is no need to push a fix for them before merging.

Comment thread pkg/cmd/claude/claude.go Resolved
…856)

cobra's Deprecated prints via OutOrStderr, which is docker's stdout when
depot runs as a Docker CLI plugin. Print the notice to ErrOrStderr in
RunE instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@121watts

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-18T17:34:23.010855Z c85174d Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. More of your lovely PRs please.

Reviewed commit: c85174d6b0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@claude claude Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. The follow-up commit fixes the Docker-plugin stdout issue I raised earlier: it drops cobra's Deprecated field and writes the notice with cmd.ErrOrStderr().

What was reviewed:

  • pkg/cmd/claude/claude.go: Hidden: true, and the notice is printed at the top of RunE. That covers the list-sessions, secrets and default paths, and the dispatch logic is unchanged.
  • pkg/cmd/root/root_test.go: the new test covers hiding from --help and __complete, lookup with cmd.Find, and the notice going to stderr.
Extended reasoning...

The change touches two files: it hides the depot claude cobra command, prints a one-line deprecation notice to stderr in its RunE, and adds a root-level test. It touches no auth, crypto or data-exposure surface, and command execution is otherwise unchanged. My only earlier concern, that the notice could reach stdout in Docker-plugin mode, was fixed in commit c85174d. There is no CODEOWNERS file, and no other reviewer has an open objection.

@121watts
121watts merged commit 3a33e24 into main Nov 18, 2026
13 checks passed
@121watts
121watts deleted the watts/dep-8856-remove-deprecated-remote-agents-claude-from branch November 18, 2026 18:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant