Skip to content

fix(delegate): correct ACP docs — Claude Code CLI has no --acp flag (salvage #19058)#21201

Merged
teknium1 merged 1 commit into
mainfrom
salvage/pr-19058
May 7, 2026
Merged

fix(delegate): correct ACP docs — Claude Code CLI has no --acp flag (salvage #19058)#21201
teknium1 merged 1 commit into
mainfrom
salvage/pr-19058

Conversation

@teknium1
Copy link
Copy Markdown
Contributor

@teknium1 teknium1 commented May 7, 2026

Closes #19058 via salvage. Fixes #19055. Also supersedes #19059 (same fix, landed 22 min later).

Summary

delegate_task tool schema said claude --acp --stdio works. Claude Code CLI has no --acp or --stdio flag — the ACP subprocess transport (agent/copilot_acp_client.py) is built for GitHub Copilot (copilot --acp --stdio). Correct the schema text so models don't waste calls trying to spawn claude via ACP.

Validation

Verified against local claude CLI — no --acp option. copilot remains the only ACP-capable command.

Original author: @liuhao1024.

The delegate_task tool schema descriptions referenced 'claude --acp --stdio'
as an example, but Claude Code CLI does not support --acp or --stdio flags.

The ACP subprocess transport (agent/copilot_acp_client.py) is specifically
built for GitHub Copilot CLI ('copilot --acp --stdio').

Changes:
- Per-task acp_command example: 'claude' → 'copilot'
- Top-level acp_command description: remove 'Claude Code' reference,
  clarify requirement for ACP-compatible CLI (currently Copilot only)
- acp_args description: remove misleading claude-opus-4-6 example

Fixes #19055
@teknium1 teknium1 merged commit 6969203 into main May 7, 2026
10 of 11 checks passed
@teknium1 teknium1 deleted the salvage/pr-19058 branch May 7, 2026 12:13
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

🔎 Lint report: salvage/pr-19058 vs origin/main

ruff

Total: 0 on HEAD, 0 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 0 pre-existing issues carried over.

ty (type checker)

Total: 7483 on HEAD, 7483 on base (➖ 0)

🆕 New issues (3):

Rule Count
invalid-argument-type 3
First entries
run_agent.py:6454: [invalid-argument-type] invalid-argument-type: Argument to function `build_anthropic_client` is incorrect: Expected `str`, found `str | dict[Unknown, Unknown] | Any | ... omitted 3 union elements`
run_agent.py:12318: [invalid-argument-type] invalid-argument-type: Argument to function `len` is incorrect: Expected `Sized`, found `(str & ~AlwaysFalsy) | (dict[Unknown, Unknown] & ~AlwaysFalsy) | (Any & ~AlwaysFalsy) | ... omitted 3 union elements`
run_agent.py:12315: [invalid-argument-type] invalid-argument-type: Argument to function `_is_oauth_token` is incorrect: Expected `str`, found `str | dict[Unknown, Unknown] | Any | ... omitted 3 union elements`

✅ Fixed issues (3):

Rule Count
invalid-argument-type 3
First entries
run_agent.py:6454: [invalid-argument-type] invalid-argument-type: Argument to function `build_anthropic_client` is incorrect: Expected `str`, found `str | dict[Unknown | str, Unknown | str | dict[str, str]] | Any | ... omitted 3 union elements`
run_agent.py:12318: [invalid-argument-type] invalid-argument-type: Argument to function `len` is incorrect: Expected `Sized`, found `(str & ~AlwaysFalsy) | (dict[Unknown | str, Unknown | str | dict[str, str]] & ~AlwaysFalsy) | (Any & ~AlwaysFalsy) | ... omitted 3 union elements`
run_agent.py:12315: [invalid-argument-type] invalid-argument-type: Argument to function `_is_oauth_token` is incorrect: Expected `str`, found `str | dict[Unknown | str, Unknown | str | dict[str, str]] | Any | ... omitted 3 union elements`

Unchanged: 3929 pre-existing issues carried over.

Diagnostics are surfaced as warnings — this check never fails the build.

@alt-glitch alt-glitch added type/docs Documentation improvements tool/delegate Subagent delegation comp/acp Agent Communication Protocol adapter P3 Low — cosmetic, nice to have labels May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/acp Agent Communication Protocol adapter P3 Low — cosmetic, nice to have tool/delegate Subagent delegation type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bug: delegate_tool.py docs claim 'claude --acp --stdio' works — Claude Code CLI has no --acp flag

3 participants