{ "schemaVersion": 1, "updatedAt": "2026-10-15", "dimensions": [ "agentServer", "sessionHistory", "editorFiles", "editorTerminal", "editorMcp", "acpClient" ], "contracts": [ { "harness": "codex", "variant": "codex-acp", "default": true, "verifiedAt": "2026-10-15", "surface": "acp", "evidence": [ "acp-codex-readme", "acp-codex-package", "acp-codex-cli-help", "acp-codex-codex-cargo", "acp-codex-init-probe", "acp-codex-registry", "acp-codex-zed-docs", "acp-codex-readme-dev", "acp-codex-auth-methods", "acp-codex-session-handlers", "acp-codex-list-sessions", "acp-codex-modes", "acp-codex-config-options", "acp-codex-collab-mode", "acp-codex-commands", "acp-codex-permission-options", "acp-codex-turn-policy", "acp-codex-client-caps", "acp-codex-diff", "acp-codex-terminal-render", "acp-codex-mcp", "acp-codex-prompt-content", "acp-codex-plan-stream", "acp-codex-usage", "acp-codex-subagents", "acp-codex-initialize" ], "references": [ "https://github.com/agentclientprotocol/registry/blob/6f6e55b0fb5ac6dcd7d6ca79fa17774213d97b16/codex-acp/agent.json#L1-L27", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAuthMethod.ts#L72-L90", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpClient.ts#L1272-L1305", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/AgentMode.ts#L41-L151", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexCommands.ts#L67-L215", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/permissions/options.ts#L15-L76", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/tool-calls/reporters/FileChangeReporter.ts#L90-L140", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/tool-calls/AcpToolCallRenderer.ts#L70-L155", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpClient.ts#L965-L1061", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpClient.ts#L1362-L1392", "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpServer.ts#L453-L536" ], "support": { "agentServer": "adapter", "sessionHistory": "native", "editorFiles": "unsupported", "editorTerminal": "unsupported", "editorMcp": "partial", "acpClient": "unsupported" }, "conditions": [ "Runs through `@agentclientprotocol/codex-acp` adapter, not a built-in command.", "Reads and writes files and runs commands itself instead of through the editor." ], "unknowns": [ "No prompt turns were sent; behaviour during a model turn comes from source and docs." ], "details": { "sourceRevision": "agentclientprotocol/codex-acp v2.2.2 @ 202e66e63343ec4f5a5e35ab590251d813d129ca; openai/codex rust-v0.162.1 @ 092d3acd6bec3e3a14bdc7e7a2810ab628ab759d" }, "observedVersion": "codex-acp 2.2.2, Codex 0.162.1", "notes": [ "Codex itself has no ACP mode; every answer here describes the `@agentclientprotocol/codex-acp` adapter driving `codex app-server`.", "JetBrains AIR clients get extra `_meta.jetbrains.air` extensions (goals, async tasks, Git-patch diffs) that other editors do not see." ], "answers": { "run": { "status": "supported", "answer": "Codex has no ACP mode of its own; run the adapter `npx -y @agentclientprotocol/codex-acp` (binary `codex-acp`), which starts `codex app-server` and translates between the two protocols. It bundles Codex 0.160.1; set `CODEX_PATH=/path/to/codex` to use your own Codex.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/README.md#L27-L46", "evidence": [ "acp-codex-readme", "acp-codex-package", "acp-codex-cli-help", "acp-codex-codex-cargo", "acp-codex-init-probe" ], "notes": [ "The older Rust `zed-industries/codex-acp` repository is archived; the current adapter lives at `agentclientprotocol/codex-acp`.", "A `@preview` npm tag tracks unreleased `main`." ] }, "editors": { "status": "supported", "answer": "The ACP registry lists it as `codex-acp` (npx `@agentclientprotocol/codex-acp@2.2.2`), so Zed and JetBrains install it from their registry UI. Zed users start a Codex thread from the Agent Panel; for a custom build add an `agent_servers` entry with `\"command\": \"/path/to/codex-acp\"` and optional `\"env\": {\"CODEX_PATH\": \"/path/to/codex\"}`.", "reference": "https://github.com/agentclientprotocol/registry/blob/6f6e55b0fb5ac6dcd7d6ca79fa17774213d97b16/codex-acp/agent.json#L1-L27", "evidence": ["acp-codex-registry", "acp-codex-zed-docs", "acp-codex-readme-dev"] }, "auth": { "status": "supported", "answer": "`initialize` advertises `api-key` (reads `CODEX_API_KEY`, then `OPENAI_API_KEY`) and `chat-gpt` (browser login, hidden when `NO_BROWSER` is set). Clients that support URL elicitation also get `chat-gpt-device-code`, and clients that opt in get a `gateway` method for a custom OpenAI-compatible endpoint. Existing `codex login` credentials in `~/.codex` are reused, and `/logout` or `authentication/logout` signs out.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAuthMethod.ts#L72-L90", "evidence": ["acp-codex-auth-methods", "acp-codex-init-probe", "acp-codex-readme"] }, "resume": { "status": "supported", "answer": "`loadSession` is true and `sessionCapabilities` advertises `list`, `resume`, `fork`, `close` and `delete`, so editors can list, reload (with history replay), resume and fork sessions. Listing reads Codex's own thread store across `cli`, `vscode`, `exec` and `appServer` sources, so sessions started in the terminal `codex` show up in the editor and vice versa.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpClient.ts#L1272-L1305", "evidence": [ "acp-codex-init-probe", "acp-codex-session-handlers", "acp-codex-list-sessions" ], "notes": [ "`session/list` is filtered to the active model provider and, when given, the `cwd`." ] }, "modes": { "status": "supported", "answer": "`session/set_mode` and config options switch between `read-only`, `workspace-write`, `agent` (Auto review, the default) and `agent-full-access`; `INITIAL_AGENT_MODE` picks the starting mode. Config options also cover `model`, `reasoning_effort`, `fast-mode` (where the model supports it) and `collaboration_mode` (Default or Plan).", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/AgentMode.ts#L41-L151", "evidence": ["acp-codex-modes", "acp-codex-config-options", "acp-codex-collab-mode"] }, "commands": { "status": "supported", "answer": "The adapter sends `available_commands_update` with built-ins `/plan`, `/mcp`, `/skills`, `/status`, `/review`, `/review-branch`, `/review-commit`, `/compact`, `/goal`, `/rename` and `/logout`, plus every Codex skill found for the session's roots as `$skill-name`.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexCommands.ts#L67-L215", "evidence": ["acp-codex-commands", "acp-codex-readme"], "notes": ["Codex custom prompts are not listed; skills are."] }, "permissions": { "status": "supported", "answer": "Codex approval requests become `session/request_permission` with options such as `Yes, proceed` (allow_once), `Yes, and don't ask again for this command in this session` or for a command prefix (allow_always), network-host allow/block, and `No, and tell Codex what to do differently` (reject_once). Approval and sandbox policy come from the ACP mode sent on every turn, not from `approval_policy`/`sandbox_mode` in `config.toml`; Codex exec-policy rules still apply, and prefix approvals are saved as rules.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/permissions/options.ts#L15-L76", "evidence": ["acp-codex-permission-options", "acp-codex-turn-policy", "acp-codex-modes"] }, "files": { "status": "unsupported", "answer": "Codex reads and writes files itself on disk; the adapter never calls `fs/read_text_file` or `fs/write_text_file`, so unsaved editor buffers are not seen. Edits are reported back as tool calls with ACP `diff` content, so the editor still shows the change.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/tool-calls/reporters/FileChangeReporter.ts#L90-L140", "evidence": ["acp-codex-client-caps", "acp-codex-diff"] }, "terminal": { "status": "unsupported", "answer": "Commands run in Codex's own sandboxed shell; the adapter never calls `terminal/create`. Output streams into the tool call as `terminal` content with `_meta.terminal_output` / `terminal_output_delta` chunks for clients that declare them (the Zed convention), otherwise as text.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/tool-calls/AcpToolCallRenderer.ts#L70-L155", "evidence": ["acp-codex-client-caps", "acp-codex-terminal-render"] }, "mcp": { "status": "partial", "answer": "Servers passed in `session/new` are added to the session's Codex config for stdio (`command`) and `http` transports; `sse` and `acp` transports are rejected (`mcpCapabilities.sse: false`). Codex also keeps loading its own `mcp_servers` from `config.toml`, and a requested server whose name already exists there is skipped (set `DISABLE_MCP_CONFIG_FILTERING=true` to turn that off).", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpClient.ts#L965-L1061", "evidence": ["acp-codex-mcp", "acp-codex-init-probe"] }, "content": { "status": "partial", "answer": "Prompts accept text, images, embedded resources (inlined as `` blocks) and resource links (as text links); audio is advertised false and dropped. Back come agent message and thought chunks, `plan` entries and plan-mode markdown (`plan_update` when the client declares plan support), tool calls with diffs and command output, `usage_update`, session title updates and, after negotiation, native subagent sessions.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpClient.ts#L1362-L1392", "evidence": [ "acp-codex-prompt-content", "acp-codex-init-probe", "acp-codex-plan-stream", "acp-codex-usage", "acp-codex-subagents" ] }, "client": { "status": "unsupported", "answer": "Neither Codex 0.162.1 nor the adapter can drive other ACP agents: the Codex CLI has no ACP command or ACP dependency, and the adapter only implements the agent side. Codex subagents are its own threads, which the adapter can surface to the editor as ACP subagent sessions.", "reference": "https://github.com/agentclientprotocol/codex-acp/blob/202e66e63343ec4f5a5e35ab590251d813d129ca/src/CodexAcpServer.ts#L453-L536", "evidence": [ "acp-codex-cli-help", "acp-codex-codex-cargo", "acp-codex-subagents", "acp-codex-initialize" ] } } }, { "harness": "claude-code", "variant": "claude-agent-acp", "default": true, "verifiedAt": "2026-10-15", "surface": "acp", "evidence": [ "acp-claude-code-probe-help", "acp-claude-code-pkg", "acp-claude-code-deps", "acp-claude-code-entry", "acp-claude-code-cli-path", "acp-claude-code-probe-sdk", "acp-claude-code-npm-old", "acp-claude-code-registry", "acp-claude-code-zed-docs", "acp-claude-code-readme", "acp-claude-code-initialize", "acp-claude-code-probe-init", "acp-claude-code-authenticate", "acp-claude-code-hide-auth", "acp-claude-code-sessions", "acp-claude-code-methods", "acp-claude-code-modes", "acp-claude-code-model-option", "acp-claude-code-effort-option", "acp-claude-code-fast-option", "acp-claude-code-commands", "acp-claude-code-unsupported-commands", "acp-claude-code-can-use-tool", "acp-claude-code-perm-options", "acp-claude-code-query-options", "acp-claude-code-changelog-tools", "acp-claude-code-terminal-meta", "acp-claude-code-mcp", "acp-claude-code-prompt", "acp-claude-code-stream", "acp-claude-code-docs-index" ], "references": [ "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/index.ts#L13-L108", "https://github.com/agentclientprotocol/registry/blob/6f6e55b0fb5ac6dcd7d6ca79fa17774213d97b16/claude-acp/agent.json#L1-L27", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L2970-L3045", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/session-mode.ts#L350-L392", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L9661-L9686", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L9305-L9330", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/CHANGELOG.md#L1087-L1090", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/tool-calls/client-capabilities.ts#L10-L60", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L10281-L10305", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L11835-L11900", "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L12705-L12746" ], "support": { "agentServer": "adapter", "sessionHistory": "native", "editorFiles": "unsupported", "editorTerminal": "unsupported", "editorMcp": "native", "acpClient": "unsupported" }, "conditions": [ "Runs through `@agentclientprotocol/claude-agent-acp` adapter, not a built-in command.", "Reads and writes files and runs commands itself instead of through the editor." ], "unknowns": [ "No prompt turns were sent; behaviour during a model turn comes from source and docs." ], "details": { "sourceRevision": "7f7a1404a15024a45e62b699ced4de3fb7a814a2 (tag v0.90.0)" }, "observedVersion": "claude-agent-acp 0.90.0", "notes": [ "Claude Code has no native ACP mode; editors run the `claude-agent-acp` adapter, which spawns Claude Code through the Claude Agent SDK.", "The adapter bundles its own Claude Code build (2.1.296 in adapter 0.90.0), which lags the terminal release; set `CLAUDE_CODE_EXECUTABLE` to use your installed `claude`.", "Settings, CLAUDE.md, hooks, skills and MCP config are read from the same user/project/local sources as the terminal app." ], "answers": { "run": { "status": "supported", "answer": "Claude Code has no ACP mode of its own; run the adapter `npx @agentclientprotocol/claude-agent-acp` (binary `claude-agent-acp`), built on the Claude Agent SDK. It bundles Claude Code 2.1.296; set `CLAUDE_CODE_EXECUTABLE` to use your own `claude`.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/index.ts#L13-L108", "evidence": [ "acp-claude-code-probe-help", "acp-claude-code-pkg", "acp-claude-code-deps", "acp-claude-code-entry", "acp-claude-code-cli-path", "acp-claude-code-probe-sdk", "acp-claude-code-npm-old" ], "notes": [ "The package was formerly `@zed-industries/claude-code-acp` (repo `zed-industries/claude-code-acp`); that name is deprecated at 0.16.2.", "`claude-agent-acp --cli ` runs the bundled Claude Code CLI directly, e.g. for login.", "Set `CLAUDE_AGENT_ACP_EXPERIMENTAL_V2=1` to also serve the draft ACP v2 to clients that ask for it." ] }, "editors": { "status": "supported", "answer": "The ACP registry lists it as `claude-acp` (\"Claude Agent\"), launched with `npx @agentclientprotocol/claude-agent-acp@0.90.0`, so registry-aware editors such as Zed (`zed: acp registry`, or Agent Settings > External Agents > Install from Registry) and JetBrains install it in one step. Other clients can configure it as a custom stdio agent running `npx @agentclientprotocol/claude-agent-acp`.", "reference": "https://github.com/agentclientprotocol/registry/blob/6f6e55b0fb5ac6dcd7d6ca79fa17774213d97b16/claude-acp/agent.json#L1-L27", "evidence": [ "acp-claude-code-registry", "acp-claude-code-zed-docs", "acp-claude-code-readme" ], "notes": [ "The registry also carries a `preview` channel (`0.90.1-preview.12`) built from every push to `main`." ] }, "auth": { "status": "supported", "answer": "Sign-in reuses Claude Code's own credentials (`claude auth login`, `ANTHROPIC_API_KEY`, or Bedrock/Vertex env), and the agent pushes the current identity on `_auth/status_update`. When the client declares `auth.terminal`, `initialize` advertises terminal auth methods `claude-ai-login` (Claude subscription) and `console-login` (Anthropic Console), which run `claude-agent-acp --cli auth login --claudeai|--console`; over SSH it offers `claude-login` instead. Clients that declare `auth._meta.gateway` also get `gateway`/`gateway-bedrock` methods, and `logout` is supported.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L2730-L2858", "evidence": [ "acp-claude-code-initialize", "acp-claude-code-probe-init", "acp-claude-code-authenticate", "acp-claude-code-hide-auth" ], "notes": [ "Launch with `--hide-claude-auth` to hide the subscription login and refuse turns a claude.ai subscription would pay for." ] }, "resume": { "status": "supported", "answer": "It implements `session/list`, `session/load` (with history replay), `session/resume`, `session/fork`, `session/close` and `session/delete`. Sessions are Claude Code's own transcripts, so conversations started in the editor show up in `claude --resume` and vice versa.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L2970-L3045", "evidence": [ "acp-claude-code-sessions", "acp-claude-code-methods", "acp-claude-code-probe-init" ], "notes": [ "`session/list` can be filtered by `cwd` and is paged with a cursor.", "Subagent child sessions are replayed from their own transcripts when the client declares `subagents`." ] }, "modes": { "status": "supported", "answer": "`session/set_mode` switches among `default` (Manual), `acceptEdits`, `plan`, `auto` and, unless disabled by settings or running as root outside a sandbox, `bypassPermissions`. Model, effort (`thought_level`) and Fast mode are session config options changed with `session/set_config_option`; there is no separate `session/set_model` handler.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/session-mode.ts#L350-L392", "evidence": [ "acp-claude-code-modes", "acp-claude-code-model-option", "acp-claude-code-effort-option", "acp-claude-code-fast-option", "acp-claude-code-methods" ], "notes": [ "The mode is also exposed as a config option, so clients that only use config options can switch it too." ] }, "commands": { "status": "supported", "answer": "After session setup the agent sends `available_commands_update` with Claude Code's slash commands, including custom commands, skills and MCP prompts. A few terminal-only commands such as `/clear`, `/cost`, `/login`, `/logout` and `/todos` are withheld, and `/mcp` is answered by the adapter itself.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L9661-L9686", "evidence": [ "acp-claude-code-commands", "acp-claude-code-unsupported-commands", "acp-claude-code-readme" ] }, "permissions": { "status": "supported", "answer": "Whenever Claude Code would prompt, the adapter sends `session/request_permission` with options such as `allow_once` (\"Yes\"), `allow_always` (\"Yes, and don't ask again for ...\", which saves a Claude Code permission rule) and `reject_once` (\"No\"). Claude Code's own `permissions` allow/deny rules from user, project and local settings, and the current permission mode, still apply, so only undecided calls reach the editor.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L9305-L9330", "evidence": [ "acp-claude-code-can-use-tool", "acp-claude-code-perm-options", "acp-claude-code-query-options", "acp-claude-code-modes" ], "notes": [ "Exiting plan mode is offered as a permission request whose options pick the next mode (auto, accept edits, bypass, or manual)." ] }, "files": { "status": "unsupported", "answer": "Claude Code's built-in Read, Edit and Write tools work directly on disk, and the adapter never calls `fs/read_text_file` or `fs/write_text_file`, so unsaved editor buffers are not seen. Edits are still reported to the editor as tool calls with diffs.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/CHANGELOG.md#L1087-L1090", "evidence": [ "acp-claude-code-changelog-tools", "acp-claude-code-query-options", "acp-claude-code-initialize" ] }, "terminal": { "status": "unsupported", "answer": "Commands run in Claude Code's own Bash tool, and the adapter never calls `terminal/create`. Clients that opt in with `_meta.terminal_output` (or `terminal_output_delta`) get the command output rendered as a terminal via `_meta.terminal_info`/`terminal_output`/`terminal_exit` on the tool call.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/tool-calls/client-capabilities.ts#L10-L60", "evidence": ["acp-claude-code-changelog-tools", "acp-claude-code-terminal-meta"] }, "mcp": { "status": "supported", "answer": "MCP servers passed in `session/new` are used, with stdio, `http` and `sse` transports (`mcpCapabilities.http` and `.sse` are advertised). Claude Code also loads its own configured MCP servers from user, project and local settings and `.mcp.json`, alongside the editor's.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L10281-L10305", "evidence": [ "acp-claude-code-mcp", "acp-claude-code-query-options", "acp-claude-code-probe-init" ], "notes": [ "`/mcp` in the chat lists server status and can reconnect, enable or disable a server; reconnecting a server that needs auth starts MCP OAuth via URL elicitation." ] }, "content": { "status": "partial", "answer": "Prompts can carry text, images (base64 or http URL), embedded text resources (added as `` blocks) and resource links; audio and binary blob resources are dropped. Streamed back are message and thought chunks, plans (`plan` from TodoWrite), tool calls with diffs, terminal output, `usage_update` with token usage and cost, and subagent child sessions for clients that declare `subagents`.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L11835-L11900", "evidence": [ "acp-claude-code-prompt", "acp-claude-code-stream", "acp-claude-code-probe-init", "acp-claude-code-readme" ] }, "client": { "status": "unsupported", "answer": "Neither Claude Code nor the adapter can drive other ACP agents. Claude Code's subagents are its own Agent tool, not ACP agents.", "reference": "https://github.com/agentclientprotocol/claude-agent-acp/blob/7f7a1404a15024a45e62b699ced4de3fb7a814a2/src/acp-agent.ts#L12705-L12746", "evidence": [ "acp-claude-code-probe-help", "acp-claude-code-docs-index", "acp-claude-code-methods" ] } } }, { "harness": "cursor-agent", "variant": "agent acp", "default": true, "verifiedAt": "2026-10-15", "surface": "acp", "evidence": [ "acp-cursor-agent-docs", "acp-cursor-agent-help", "acp-cursor-agent-probe-initialize", "acp-cursor-agent-registry", "acp-cursor-agent-docs-jetbrains", "acp-cursor-agent-bundle", "acp-cursor-agent-probe-session-list", "acp-cursor-agent-probe-session-new" ], "references": [ "https://cursor.com/docs/cli/acp#sessions", "https://cursor.com/docs/cli/acp#request-flow" ], "support": { "agentServer": "native", "sessionHistory": "partial", "editorFiles": "unsupported", "editorTerminal": "unsupported", "editorMcp": "native", "acpClient": "unsupported" }, "conditions": [ "Reads and writes files and runs commands itself instead of through the editor." ], "unknowns": [ "No prompt turns were sent; behaviour during a model turn comes from source and docs." ], "details": { "sourceRevision": "closed source; installed bundle 2026.10.12-d47ca18 (registry lists 2026.10.14-0f9edde)" }, "observedVersion": "2026.10.12", "notes": [ "ACP is built into the Cursor Agent CLI (`agent acp`); there is no separate adapter package.", "Cursor adds its own `cursor/*` extension methods (`cursor/ask_question`, `cursor/create_plan`, `cursor/update_todos`, `cursor/task`, `cursor/generate_image`) that generic ACP clients can ignore or implement.", "Behaviour below was checked against 2026.10.12-d47ca18; the ACP registry currently ships 2026.10.14-0f9edde." ], "answers": { "run": { "status": "supported", "answer": "Run `agent acp`; ACP is native to the Cursor Agent CLI, so no adapter package is needed. It speaks newline-delimited JSON-RPC 2.0 over stdio and logs to stderr.", "reference": "https://cursor.com/docs/cli/acp#start-acp-server", "evidence": [ "acp-cursor-agent-docs", "acp-cursor-agent-help", "acp-cursor-agent-probe-initialize" ] }, "editors": { "status": "supported", "answer": "Cursor is in the ACP registry as `cursor`, which downloads the CLI package and launches `cursor-agent acp`, so registry-aware clients such as Zed and JetBrains can install it directly. Cursor documents JetBrains IDEs, Zed and Neovim via avante.nvim (`cursor` provider, `auth_method = \"cursor_login\"`); any other client can spawn `agent acp`.", "reference": "https://cursor.com/docs/cli/acp#ide-integrations", "evidence": [ "acp-cursor-agent-registry", "acp-cursor-agent-docs", "acp-cursor-agent-docs-jetbrains" ] }, "auth": { "status": "supported", "answer": "The only advertised auth method is `cursor_login`. Sign in beforehand with `agent login`, or launch with `--api-key`/`CURSOR_API_KEY` or `--auth-token`/`CURSOR_AUTH_TOKEN`; the client then calls `authenticate` with `methodId: \"cursor_login\"`. Session calls made without credentials fail with an auth-required error telling the user to run `agent login`.", "reference": "https://cursor.com/docs/cli/acp#authentication", "evidence": [ "acp-cursor-agent-probe-initialize", "acp-cursor-agent-docs", "acp-cursor-agent-bundle" ] }, "resume": { "status": "partial", "answer": "`session/list` (optional `cwd` filter, no pagination) and `session/load` work, and loading replays the conversation history to the editor. There is no `session/resume` or `session/fork`. ACP sessions are stored separately under `~/.cursor/acp-sessions/`, so terminal chats from `agent --resume` are not listed or loadable, and the other way round.", "reference": "https://cursor.com/docs/cli/acp#sessions", "evidence": [ "acp-cursor-agent-probe-initialize", "acp-cursor-agent-probe-session-list", "acp-cursor-agent-bundle" ] }, "modes": { "status": "supported", "answer": "`session/new` returns modes `agent`, `plan` and `ask` plus the full model list, and exposes both as `configOptions` (`mode`, `model`). Switch them with `session/set_mode`, `session/set_config_option` or `session/set_model`. Model ids carry Cursor's bracketed parameters, such as `claude-opus-4-8[thinking=true,context=300k,effort=high,fast=false]`.", "reference": "https://cursor.com/docs/cli/acp#modes", "evidence": ["acp-cursor-agent-probe-session-new", "acp-cursor-agent-bundle"] }, "commands": { "status": "supported", "answer": "After `session/new` or `session/load`, the agent sends `available_commands_update` listing Cursor commands and skills (built-in, global and project, e.g. `create-skill`, `loop`, `rename-chat`). Sending `/name args` as prompt text runs the matching command or skill.", "reference": "https://cursor.com/docs/cli/acp#sessions", "evidence": ["acp-cursor-agent-probe-session-new", "acp-cursor-agent-bundle"] }, "permissions": { "status": "supported", "answer": "Shell, write, delete, read, MCP and web tool calls go through `session/request_permission` with the options `allow-once`, `allow-always` and `reject-once`. Choosing `allow-always` adds the command, path or MCP tool to the CLI's permission allowlist. Existing `permissions.allow` entries and Run Everything (`--force`/`--yolo`) skip the prompt.", "reference": "https://cursor.com/docs/cli/acp#permissions", "evidence": ["acp-cursor-agent-docs", "acp-cursor-agent-bundle"], "notes": [ "Cursor also asks multiple-choice questions and plan approvals through its own `cursor/ask_question` and `cursor/create_plan` methods. The question flow falls back to `session/request_permission` options." ] }, "files": { "status": "unsupported", "answer": "Files are read and written directly on disk, even when the client advertises `fs.readTextFile`/`fs.writeTextFile`, so unsaved editor buffers are not seen. Edits still reach the editor as `diff` content (path, old text, new text) on the permission request and tool call.", "reference": "https://cursor.com/docs/cli/acp#request-flow", "evidence": ["acp-cursor-agent-bundle", "acp-cursor-agent-probe-initialize"] }, "terminal": { "status": "unsupported", "answer": "Commands run in Cursor's own shell, even when the client advertises `terminal: true`. The agent never calls `terminal/create`, so output streams back only as tool call updates.", "reference": "https://cursor.com/docs/cli/acp#request-flow", "evidence": ["acp-cursor-agent-bundle", "acp-cursor-agent-probe-initialize"] }, "mcp": { "status": "supported", "answer": "Servers passed in `session/new`/`session/load` are used: stdio (`command`, `args`, `env`), and `http` and `sse` (`url`, `headers`), which are advertised in `mcpCapabilities`. They are added to the servers from the user's and project's `.cursor/mcp.json`, which still need approval in the CLI first. Dashboard team MCP servers are not loaded in ACP mode.", "reference": "https://cursor.com/docs/cli/acp#mcp-servers", "evidence": [ "acp-cursor-agent-probe-initialize", "acp-cursor-agent-docs", "acp-cursor-agent-bundle" ] }, "content": { "status": "partial", "answer": "Prompts accept text, images and resource links. Audio is not supported, and `embeddedContext` is advertised as false. Linked `file:` URIs inside the project root, and embedded text resources, are inlined as extra context. Streamed back: message and thought chunks, tool calls with diffs, `plan` entries, mode changes, session titles (`session_info_update`) and subagent updates; there is no `usage_update`.", "reference": "https://cursor.com/docs/cli/acp#request-flow", "evidence": ["acp-cursor-agent-probe-initialize", "acp-cursor-agent-bundle"], "notes": [ "Todo lists, subagent status and generated images also arrive through Cursor's `cursor/update_todos`, `cursor/task` and `cursor/generate_image` notifications." ] }, "client": { "status": "unsupported", "answer": "The Cursor CLI only acts as an ACP agent. It cannot launch or drive other ACP agents, and its subagents are Cursor's own.", "reference": "https://cursor.com/docs/cli/acp#overview", "evidence": ["acp-cursor-agent-bundle", "acp-cursor-agent-docs"] } } }, { "harness": "opencode", "variant": "2.x", "default": true, "verifiedAt": "2026-10-15", "surface": "acp", "evidence": [ "acp-opencode-handler", "acp-opencode-docs-v2", "acp-opencode-v1-probe", "acp-opencode-registry", "acp-opencode-docs-v1", "acp-opencode-initialize", "acp-opencode-dispatch", "acp-opencode-config-options", "acp-opencode-commands", "acp-opencode-turn-commands", "acp-opencode-permission", "acp-opencode-connection", "acp-opencode-mcp-filter", "acp-opencode-mcp-register", "acp-opencode-content", "acp-opencode-translate", "acp-opencode-usage" ], "references": [ "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/commands/handlers/acp.ts#L13-L60", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/service.ts#L106-L136", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/agent.ts#L68-L119", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/config-option.ts#L20-L70", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/sessions.ts#L74-L92", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/permission.ts#L39-L74", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/connection.ts#L20-L70", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/service.ts#L243-L253", "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/content.ts#L15-L45" ], "support": { "agentServer": "native", "sessionHistory": "native", "editorFiles": "unsupported", "editorTerminal": "unsupported", "editorMcp": "partial", "acpClient": "unsupported" }, "conditions": [ "Reads and writes files and runs commands itself instead of through the editor." ], "unknowns": [ "No prompt turns were sent; behaviour during a model turn comes from source and docs." ], "details": { "sourceRevision": "042d0832f5f3a73eaa039a58a7d565776f6d4290 (tag v2.0.29); 1.x notes at 51ef4be1d3c122f18fefb510dca8d778571f4f18 (tag v1.18.33)" }, "observedVersion": "2.0.29", "notes": [ "Answers describe OpenCode 2.x (`@opencode/cli`). 1.x (`opencode-ai`) uses the same `opencode acp` command; differences are called out per question.", "The ACP registry and Zed's registry install currently ship the 1.x binary." ], "answers": { "run": { "status": "supported", "answer": "Run `opencode acp`; ACP is built into OpenCode, no adapter package is needed. It speaks newline-delimited JSON-RPC (protocol version 1) on stdin/stdout, starts its own private OpenCode server and exits when stdin closes.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/commands/handlers/acp.ts#L13-L60", "evidence": ["acp-opencode-handler", "acp-opencode-docs-v2", "acp-opencode-v1-probe"], "notes": [ "Add `--print-logs` before `acp` (`opencode --print-logs acp`) to send logs to stderr when debugging; stdout carries only ACP messages.", "1.x (`opencode-ai`) uses the same `opencode acp` command." ] }, "editors": { "status": "supported", "answer": "OpenCode is in the ACP registry (id `opencode`), so Zed can install it via `zed: acp registry`. For a custom binary, add `\"agent_servers\": {\"OpenCode\": {\"command\": \"opencode\", \"args\": [\"acp\"]}}` to Zed's `settings.json` or JetBrains' `acp.json`; Avante.nvim and CodeCompanion.nvim are also documented.", "reference": "https://opencode.ai/docs/acp#zed", "evidence": ["acp-opencode-registry", "acp-opencode-docs-v1", "acp-opencode-docs-v2"], "notes": [ "The registry entry downloads the 1.x release binary (currently v1.19.0), not the 2.x `@opencode/cli`. To use 2.x in an editor, point `command` at your 2.x `opencode` binary.", "If a GUI editor cannot find `opencode`, use the absolute path from `which opencode`." ] }, "auth": { "status": "supported", "answer": "OpenCode advertises one auth method, `opencode-login`, and uses the provider credentials already stored by `opencode auth login`. If the client sets `clientCapabilities.auth.terminal`, the method becomes a terminal auth method with args `--login`, so the editor runs `opencode acp --login` in a terminal; a prompt that needs credentials fails with ACP's `auth_required` error.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/service.ts#L106-L136", "evidence": ["acp-opencode-initialize", "acp-opencode-handler", "acp-opencode-docs-v2"], "notes": [ "`authenticate` does not collect credentials; it just accepts `opencode-login`.", "Clients that set `_meta[\"terminal-auth\"]` get the login command (`opencode auth login`) in the method's `_meta`. Provider API keys can also come from the environment or OpenCode config as usual." ] }, "resume": { "status": "supported", "answer": "`session/list` (100 per page, `cwd` filter, cursor), `session/load` (replays history), `session/resume`, `session/fork`, `session/close` and `session/delete` are all supported. Sessions live in OpenCode's normal session store, so sessions started in the terminal app appear in the editor and vice versa.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/agent.ts#L68-L119", "evidence": ["acp-opencode-dispatch", "acp-opencode-initialize", "acp-opencode-docs-v2"], "notes": [ "Load, resume and fork must pass the session's original directory as `cwd`; a different `cwd` is rejected.", "1.x supports list, load, resume, fork and close but not `session/delete` or `additionalDirectories`." ] }, "modes": { "status": "supported", "answer": "Each session exposes config options `model` (enabled models as `provider/model`, optional `/variant`), `effort` (model variants, when the model has them) and `mode` (visible primary agents such as `build` and `plan`). Change them with `session/set_config_option`; `session/set_mode` also switches the agent.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/config-option.ts#L20-L70", "evidence": [ "acp-opencode-config-options", "acp-opencode-dispatch", "acp-opencode-docs-v2" ], "notes": [ "2.x has no `session/set_model`; use the `model` config option. 1.x also implements the unstable `session/set_model`.", "OpenCode sends `config_option_update` when available models or agents change or another client changes the session's model or agent." ] }, "commands": { "status": "supported", "answer": "After a session is created or loaded OpenCode sends `available_commands_update` with the project's custom commands plus the built-in `compact`, and resends it when commands change. A prompt starting with `/name` runs that command with the rest of the text as arguments.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/sessions.ts#L74-L92", "evidence": [ "acp-opencode-commands", "acp-opencode-turn-commands", "acp-opencode-docs-v2" ], "notes": ["Built-in TUI commands such as `/undo` and `/redo` are not available over ACP."] }, "permissions": { "status": "supported", "answer": "When OpenCode's permission rules say `ask`, it sends `session/request_permission` with three options: `once` (allow_once), `always` (allow_always) and `reject` (reject_once). Your `opencode.json` permission settings still apply, so `allow` and `deny` rules never reach the editor; edit requests include a `diff` preview when one can be built.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/permission.ts#L39-L74", "evidence": ["acp-opencode-permission", "acp-opencode-docs-v2"], "notes": [ "Cancelling a prompt rejects any pending permission requests. Requests from subagent (child) sessions carry `_meta[\"opencode/child-session\"]`." ] }, "files": { "status": "unsupported", "answer": "2.x reads and writes files straight to disk with its own tools and never calls `fs/read_text_file` or `fs/write_text_file`, so unsaved editor buffers are not seen. Edit diffs show up in permission requests instead.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/connection.ts#L20-L70", "evidence": ["acp-opencode-connection", "acp-opencode-dispatch"], "notes": [ "1.x (`opencode-ai`) writes an approved edit back through `fs/write_text_file` after the permission is granted, so the editor sees the change; it still reads from disk." ] }, "terminal": { "status": "unsupported", "answer": "Shell commands run in OpenCode's own shell; the ACP layer never calls `terminal/create` or other client terminal methods. Command output streams back as tool call content.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/connection.ts#L20-L70", "evidence": ["acp-opencode-connection", "acp-opencode-dispatch"] }, "mcp": { "status": "partial", "answer": "Editors can pass stdio and HTTP MCP servers in `session/new`, `session/load`, `session/resume` and `session/fork`; OpenCode adds them to the session directory for the life of the `opencode acp` process, alongside the MCP servers from its own config. SSE servers are rejected with an invalid params error.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/service.ts#L243-L253", "evidence": [ "acp-opencode-mcp-filter", "acp-opencode-mcp-register", "acp-opencode-initialize", "acp-opencode-docs-v2" ], "notes": [ "HTTP headers are passed through; OAuth is not used for editor-supplied servers. Editor-supplied servers are visible to other sessions in the same directory within that process.", "1.x advertises and accepts SSE MCP servers as well." ] }, "content": { "status": "supported", "answer": "Prompts can carry text, images, embedded resources and resource links (`file://` and `zed://` links are attached as files); audio blocks are ignored. Back come message and thought chunks, tool calls with kinds, locations and output, permission diffs, `usage_update` and end-of-turn `usage`, plus compaction and retry status.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/content.ts#L15-L45", "evidence": [ "acp-opencode-content", "acp-opencode-translate", "acp-opencode-usage", "acp-opencode-docs-v2" ], "notes": [ "OpenCode does not send `plan` updates, and tool call updates carry text/image output rather than `diff` content.", "Subagent activity is forwarded on the parent session with tool call ids prefixed `:`. If the client advertises `elicitation.form`, OpenCode asks questions with `elicitation/create`." ] }, "client": { "status": "unsupported", "answer": "OpenCode is only an ACP agent; neither 2.x nor 1.x contains ACP client code to launch or drive other ACP agents. Its subagents are OpenCode's own child sessions.", "reference": "https://github.com/anomalyco/opencode/blob/042d0832f5f3a73eaa039a58a7d565776f6d4290/packages/cli/src/acp/agent.ts#L58-L130", "evidence": ["acp-opencode-dispatch", "acp-opencode-handler"] } } }, { "harness": "pi", "variant": "pi-acp", "default": true, "verifiedAt": "2026-10-15", "surface": "acp", "evidence": [ "acp-pi-registry", "acp-pi-readme", "acp-pi-spawn", "acp-pi-pi-no-acp", "acp-pi-probe-init", "acp-pi-auth", "acp-pi-terminal-login", "acp-pi-initialize", "acp-pi-list", "acp-pi-load", "acp-pi-delete", "acp-pi-sessions-dir", "acp-pi-config", "acp-pi-commands", "acp-pi-permission", "acp-pi-pi-security", "acp-pi-diff", "acp-pi-mcp-drop", "acp-pi-pi-mcp", "acp-pi-prompt", "acp-pi-thought", "acp-pi-antigravity" ], "references": [ "https://github.com/agentclientprotocol/registry/blob/6f6e55b0fb5ac6dcd7d6ca79fa17774213d97b16/pi-acp/agent.json#L1-L17", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/auth.ts#L13-L48", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L1153-L1307", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L399-L436", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/session.ts#L915-L1005", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L281-L288", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/translate/prompt.ts#L9-L70", "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L236-L268" ], "support": { "agentServer": "adapter", "sessionHistory": "native", "editorFiles": "unsupported", "editorTerminal": "unsupported", "editorMcp": "partial", "acpClient": "unsupported" }, "conditions": [ "Runs through the community `pi-acp` adapter, not a built-in command.", "Reads and writes files and runs commands itself instead of through the editor." ], "unknowns": [ "No prompt turns were sent; behaviour during a model turn comes from source and docs." ], "details": { "sourceRevision": "svkozak/pi-acp b0581c9c1d675e634234674484247008b03d69b4 (v0.0.34); earendil-works/pi 06a466935536f8c9bcacb2d5efc0fc021be1bdff (v1.2.0)" }, "observedVersion": "pi-acp 0.0.34", "notes": [ "pi has no native ACP support; editors connect through the community `pi-acp` adapter by Sergii Kozak, which runs pi in its RPC mode.", "The adapter is pre-1.0 and expects minor breaking changes; its latest release predates pi 1.0." ], "answers": { "run": { "status": "supported", "answer": "pi has no ACP mode of its own; run the community adapter `npx -y pi-acp` (svkozak/pi-acp). It starts `pi --mode rpc` for each session, so `pi` must be on `PATH` (or set `PI_ACP_PI_COMMAND`).", "reference": "https://github.com/agentclientprotocol/registry/blob/6f6e55b0fb5ac6dcd7d6ca79fa17774213d97b16/pi-acp/agent.json#L1-L17", "evidence": [ "acp-pi-registry", "acp-pi-readme", "acp-pi-spawn", "acp-pi-pi-no-acp", "acp-pi-probe-init" ], "notes": [ "pi-acp 0.0.34 documents pi v0.81.0+ and was released before pi 1.0; 1.x compatibility is tracked in the adapter's issue #159.", "`pi --mode rpc` is pi's own JSON-over-stdio protocol, not ACP; pi-acp translates between the two.", "Other community adapters exist (`@automatalabs/pi-acp`, which embeds pi through its SDK in-process; `@wbline/pi-acp-jetbrain` for JetBrains), but only `pi-acp` is in the ACP registry." ] }, "editors": { "status": "supported", "answer": "`pi-acp` is listed in the ACP registry as `pi ACP`, so in Zed run `zed: acp registry` and pick it, which adds `\"agent_servers\": {\"pi-acp\": {\"type\": \"registry\"}}`. Without the registry, add a custom server with `\"command\": \"npx\", \"args\": [\"-y\", \"pi-acp\"]`.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/README.md#L48-L77", "evidence": ["acp-pi-registry", "acp-pi-readme"], "notes": [ "Development targets Zed; other ACP clients may work with varying compatibility." ] }, "auth": { "status": "partial", "answer": "The adapter advertises one `terminal` auth method, `pi_terminal_login`, which runs `pi-acp --terminal-login` to open interactive pi so you can log in or set API keys. There is no in-protocol API-key method; credentials come from pi's own configuration or provider env vars.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/auth.ts#L13-L48", "evidence": [ "acp-pi-auth", "acp-pi-terminal-login", "acp-pi-probe-init", "acp-pi-initialize" ], "notes": [ "If no models are available, `session/new` fails with an auth-required error carrying the same method." ] }, "resume": { "status": "supported", "answer": "`session/list`, `session/load` and `session/delete` work over pi's own session files in `~/.pi/agent/sessions/` (or the configured `sessionDir`), so sessions started in the editor can be `/resume`d in the pi terminal and vice versa. `session/resume` and fork are not implemented.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L909-L960", "evidence": [ "acp-pi-list", "acp-pi-load", "acp-pi-delete", "acp-pi-sessions-dir", "acp-pi-initialize", "acp-pi-probe-init" ], "notes": [ "`session/delete` removes the pi session file from disk.", "Without a `cwd` filter, the list defaults to the last session's working directory, like pi's `/resume` picker." ] }, "modes": { "status": "supported", "answer": "Sessions expose two config options: `Model` (all models pi can use) and `Thinking` (pi's thinking levels), via `session/set_config_option`. The legacy `session/set_mode` and `session/set_model` map to the thinking level and model respectively; there are no plan/ask-style modes.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L1153-L1307", "evidence": ["acp-pi-config"], "notes": [ "Some clients that expect a `mode`-category option (e.g. JetBrains) may not handle the thinking-level selector correctly." ] }, "commands": { "status": "partial", "answer": "After `session/new` and `session/load` the adapter sends `available_commands_update` with pi prompt templates (`~/.pi/agent/prompts`, `.pi/prompts`), skill commands as `/skill:` when enabled in pi settings, and adapter built-ins such as `/compact`, `/session`, `/name`, `/export`. Commands registered by pi extensions are not exposed.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L399-L436", "evidence": ["acp-pi-commands", "acp-pi-readme"], "notes": [ "`/model` and `/clear` are not implemented; use the editor's model selector and new-session command instead." ] }, "permissions": { "status": "partial", "answer": "pi does not ask for approval before tool calls, so tool runs never trigger `session/request_permission`. The adapter only uses `session/request_permission` to forward pi extension `confirm` (Yes/No) and `select` prompts, so a permission-gate extension installed in pi can ask through the editor.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/session.ts#L915-L1005", "evidence": ["acp-pi-permission", "acp-pi-pi-security"], "notes": [ "In RPC mode pi cannot show its project-trust prompt; project resources load only if `defaultProjectTrust` is `always` or a saved decision applies." ] }, "files": { "status": "unsupported", "answer": "pi reads and writes files directly on disk; the adapter does not call `fs/read_text_file` or `fs/write_text_file`, so unsaved editor buffers are not seen. Edits are still shown in the editor as ACP `diff` tool-call content built from before/after snapshots.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/README.md#L199-L202", "evidence": ["acp-pi-readme", "acp-pi-diff"] }, "terminal": { "status": "unsupported", "answer": "Commands run in pi's own shell via its `bash` tool; the adapter does not use `terminal/create` or other editor terminal methods.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/README.md#L199-L202", "evidence": ["acp-pi-readme"] }, "mcp": { "status": "partial", "answer": "MCP servers passed in `session/new` or `session/load` are accepted but ignored, and the adapter advertises `mcpCapabilities` `http: false, sse: false`. pi itself loads its own configured MCP servers from `~/.pi/agent/mcp.json` and `.pi/mcp.json`, which are available in ACP sessions.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L281-L288", "evidence": [ "acp-pi-mcp-drop", "acp-pi-initialize", "acp-pi-probe-init", "acp-pi-pi-mcp" ], "notes": [ "Project-level `.pi/mcp.json` loads only when the project is trusted, which RPC mode cannot prompt for." ] }, "content": { "status": "partial", "answer": "Prompts can carry text, images and resource links (passed to pi as a `[Context] ` line); embedded resources are inlined as text only when `PI_ACP_ENABLE_EMBEDDED_CONTEXT=true`, and audio is not supported. Back come message chunks, thought chunks, tool calls with file locations and edit diffs, `usage_update` context occupancy, and session titles; there are no plan updates.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/translate/prompt.ts#L9-L70", "evidence": [ "acp-pi-prompt", "acp-pi-initialize", "acp-pi-probe-init", "acp-pi-thought", "acp-pi-diff", "acp-pi-readme" ] }, "client": { "status": "unsupported", "answer": "Neither pi nor `pi-acp` can drive other ACP agents.", "reference": "https://github.com/svkozak/pi-acp/blob/b0581c9c1d675e634234674484247008b03d69b4/src/acp/agent.ts#L236-L268", "evidence": ["acp-pi-antigravity", "acp-pi-pi-no-acp", "acp-pi-initialize"], "notes": [ "The third-party pi extension `pi-antigravity-acp-provider` runs Google Antigravity's ACP server as a pi model provider; it is a single-purpose provider, not general ACP client support." ] } } } ] }