goose-acp-integration

Goose ACP Integration for {{AGENT_NAME}}

What is ACP

Agent Client Protocol (ACP) is a JSON-RPC-based standard for communicating with coding agents (GitHub: agentclientprotocol).

goose uses ACP to connect to agents like Claude Code as provider (subprocess communication over stdio):

goose → claude-agent-acp (NPM) → Claude Code CLI → Anthropic API

Key ACP providers in goose:

• claude_acp.rs — Claude Code via @agentclientprotocol/claude-agent-acp
• codex_acp.rs — OpenAI Codex
• copilot_acp.rs — GitHub Copilot

Key Protocol Types (agent_client_protocol schema)

InitializeRequest/Response   // handshake
NewSessionRequest/Response    // create session
PromptRequest/Response       // send messages
SessionNotification          // async events (tool calls, permissions, completion)
  - ToolCallStart { id, name, kind, raw_input }
  - ToolCallComplete { id, raw_output, content[], is_error }
  - PermissionRequest { request: RequestPermissionRequest }
  - Complete(StopReason, Option<Usage>)
ToolCallContent / ToolCallStatus
RequestPermissionResponse

How goose connects to Claude Code

// crates/goose/src/providers/claude_acp.rs
let config = AcpProviderConfig {
    command: resolved_command,  // path to claude-agent-acp
    args: vec![],
    env: vec![],
    work_dir: current_dir,
    mcp_servers: extension_configs_to_mcp_servers(&extensions),  // {{AGENT_NAME}} tools as MCP
    session_mode_id: Some(mode_mapping[&goose_mode].clone()),
    // mode_mapping:
    //   Auto → bypassPermissions (fully autonomous)
    //   Approve → default (ask before risky)
    //   SmartApprove → acceptEdits (auto-accept edits)
    //   Chat → plan (plan only)
};
AcpProvider::connect(name, model, goose_mode, config).await

AcpProvider (crates/goose/src/acp/provider.rs):

• Spawns subprocess (stdio JSON-RPC)
• Sends initialize then newSession
• Streams SessionNotification back (tool calls, permissions)
• Sends tool results via CallToolResult