Skip to content

[FEATURE]: ACP client mode - drive external ACP agents (Codex, Claude Code) from OpenCode #51646

Closed as not planned

Description

@knightrobin

Feature request: ACP client mode — drive external ACP agents (Codex, Claude Code) from OpenCode

Summary

OpenCode currently implements the agent side of the Agent Client Protocol: opencode acp lets any ACP-compatible editor (Zed, JetBrains AI Assistant, VS Code ACP client) drive OpenCode as an agent.

This request is for the complementary client side: let OpenCode connect to external ACP agents — e.g. Codex via @agentclientprotocol/codex-acp and Claude Code via @agentclientprotocol/claude-agent-acp — and delegate work to them, the same way an editor delegates to OpenCode today.

Motivation

The ACP agent ecosystem is consolidating under the agentclientprotocol org, with officially maintained adapters:

Other harnesses are already building ACP-client orchestration on top of these adapters (e.g. QwenPaw's dual server/client ACP support, Hermes' ACP client proposals, Warp's ACP roadmap).

For OpenCode users this unlocks agent-level integrations that MCP alone doesn't cover well today:

  • Cross-model-ecosystem second opinions: ask Codex or Claude Code to review a plan/diff from inside an OpenCode session.
  • Delegating specialized subtasks to an external agent while OpenCode orchestrates.
  • A uniform delegation surface: ACP already models sessions, streaming, permissions, and edit review — semantics OpenCode's own agent-side implementation already speaks, so the client side would reuse the same primitives from the opposite end.

For context, the MCP-based alternatives for this use case are narrowing: OpenAI removed the codex mcp-server (host-as-MCP) command (the migration target is the app-server protocol — which is what codex-acp wraps), and claude mcp serve exposes tool-level rather than agent-level semantics. ACP is the standardized agent-level option, and its adapters are officially maintained.

What it could look like

Rough sketch, purely for discussion:

{
  "acp": {
    "agents": {
      "codex": { "command": ["npx", "-y", "@agentclientprotocol/codex-acp"] },
      "claude": { "command": ["claude-agent-acp"] }
    }
  }
}

External agents could then appear as invocable agents (delegable from the orchestrator, usable as council members, etc.), with OpenCode acting as the ACP client: creating sessions, streaming events, handling permission requests, and rendering edits for review.

Concrete use case

I run OpenCode as my primary harness and keep Codex installed alongside (authenticated via the desktop app). I'd like to say "ask Codex to review this refactor" in an OpenCode session, have the orchestrator delegate to codex-acp, stream its reasoning, surface its edits for approval, and fold the conclusion back into the session — without leaving OpenCode and without a hand-rolled wrapper around codex exec.

Thanks for considering!

Activity

  1. changed the title [-][FEATURE]: ACP client mode — drive external ACP agents (Codex, Claude Code) from OpenCode[/-] [+][FEATURE]: ACP client mode - drive external ACP agents (Codex, Claude Code) from OpenCode[/+] on Sep 27, 2026
  2. github-actions commented on Sep 27, 2026

    @github-actions
    Contributor

    This issue doesn’t fully meet our contributing guidelines.

    What needs to be fixed:

    • The Feature Request template’s required verification checkbox is missing. Please add it and clarify how this request differs from the prior ACP-client requests below.

    Please edit this issue to address the above within 2 hours, or it will be automatically closed.


    This issue might be a duplicate of existing issues. Please check:

    • #28991: Support ACP-backed agents in OpenCode’s native session/TUI flow.
    • #5182: Use the TUI as an ACP client for other ACP-compatible agents.
    • #24038: Add Claude support by running an ACP agent as a subprocess.
    • #18106: Use the Web/Desktop client as an ACP client for other agents.
    • #35550: Configure agents via ACP, similar to Zed.

    If you believe this was flagged incorrectly, please let a maintainer know.

  3. github-actions commented on Sep 27, 2026

    @github-actions
    Contributor

    This issue has been automatically closed because it was not updated to meet our contributing guidelines within the 2-hour window.

    Feel free to open a new issue that follows our issue templates.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions