docs(skills): weekend CLI commands in orchestrate, doctor and the CLI reference

Merged
KI
1mo ago
+81-5

Brings the plugin skills up to date with the CLI work merged Oct 10–11.

orchestrate

  • hosts add / hosts remove for running workers on any machine reachable over SSH, with its prerequisites; agents ask before running it
  • terminals send --keys to approve prompts or interrupt (esc; warns off ctrl+c)
  • terminals wait --match for non-agent screen states
  • panes to lay workers out in the desktop app
  • terminals attach handed to the user, not run by the agent
  • notifications show when a long run finishes
  • Note that these are newer than CLI 1.37.0, with a read/send fallback

doctor: rows for hosts add hosts (repair by re-running, journalctl log, SSH/platform/curl checks, gh for private repos, lingering, bad /etc/machine-id) and the "Not a member of organization" pages publish error fixed in #8274.

CLI reference: documents hosts add / hosts remove (#8388) and drops the stale "no separate registration command" line.

Needs the next CLI release to be useful.

🤖 Generated with Claude Code


Summary by cubic

Updates the orchestrate and doctor skills and the CLI reference to document the CLI commands merged Oct 10–11.

  • orchestrate covers hosts add/hosts remove, terminals send --keys, terminals wait --match, terminals attach, panes, and notifications show, falling back to terminals read/send when a command is missing.
  • doctor adds troubleshooting rows for hosts add hosts and the "Not a member of organization" pages publish error fix.
  • The CLI reference documents hosts add/hosts remove, including when remove leaves the host's sign-in alone, and drops the stale "no separate registration command" line.
  • These commands are newer than CLI 1.37.0, so the docs require the next CLI release to be accurate.

Summary by CodeRabbit

  • Documentation
    • Added guidance for installing and signing in the CLI on supported remote machines over SSH, checking when they come online, and removing a host and its credentials.
    • Clarified how hosts become available and how to troubleshoot common host setup, connectivity, authentication, and publishing issues.
    • Expanded orchestration guidance with command compatibility notes, remote host setup requirements, terminal and desktop workflows, and notifications for completed long-running tasks.