Skip to content

Add deprecated install/sync commands for backwards compatibility#227

Merged
nhorton merged 4 commits intomainfrom
claude/add-install-deprecation-U6HE4
Feb 22, 2026
Merged

Add deprecated install/sync commands for backwards compatibility#227
nhorton merged 4 commits intomainfrom
claude/add-install-deprecation-U6HE4

Conversation

@nhorton
Copy link
Contributor

@nhorton nhorton commented Feb 22, 2026

Summary

Add deprecated install and sync CLI commands that guide users to migrate from the standalone DeepWork CLI to the Claude Code plugin distribution model. These commands are hidden from help output and will be removed after June 1st, 2026.

Key Changes

  • New module src/deepwork/cli/install.py: Contains deprecated install and sync commands that:

    • Auto-configure the DeepWork Claude plugin in .claude/settings.json
    • Display a deprecation notice instructing users to uninstall the global CLI tool
    • Are marked as hidden commands to discourage new usage
  • Updated src/deepwork/cli/main.py: Register the new deprecated commands with the CLI group

Implementation Details

  • The _install_plugin_config() function safely merges plugin configuration into existing Claude settings without overwriting other config
  • Configures both the deepwork and learning-agents plugins from the deepwork-plugins marketplace (sourced from the Unsupervisedcom/deepwork GitHub repo)
  • Both commands share the same implementation via _run_install_deprecation() to ensure consistent behavior
  • All deprecation code is clearly marked with comments indicating removal date of June 1st, 2026
  • Commands are hidden from CLI help but remain functional for backwards compatibility

https://claude.ai/code/session_01WGRUea9sYZkwvxi4cta5gu

claude and others added 4 commits February 22, 2026 20:28
DeepWork is now distributed as a Claude Code plugin rather than a
standalone CLI tool. These hidden back-compat commands auto-install
the plugin config into .claude/settings.json and display uninstall
instructions for brew/uv. Both commands are scheduled for removal
after June 1st, 2026.

https://claude.ai/code/session_01WGRUea9sYZkwvxi4cta5gu
Adds REQ-005.4 to the CLI commands spec documenting the deprecated
install and sync commands, with a scheduled removal note for June 1st
2026. Includes 13 unit tests covering deprecation message output,
hidden-from-help behavior, plugin config creation, settings merge,
and invalid JSON handling.

https://claude.ai/code/session_01WGRUea9sYZkwvxi4cta5gu
@nhorton nhorton merged commit 893d7eb into main Feb 22, 2026
4 checks passed
@nhorton nhorton deleted the claude/add-install-deprecation-U6HE4 branch February 22, 2026 20:50
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.

2 participants