ACP
What it does
Spawns external coding agents (Claude Code, Codex, Gemini CLI) via the Agent Client Protocol. Lets your assistant delegate coding tasks to specialized development tools.
Setup required
Requires the external agent to be installed (e.g., Claude Code CLI). Say “Set up ACP” for first-time configuration.
Permissions
- Host shell access for spawning external processes
Common prompts
| You say... | What happens |
|---|---|
| “Use Claude Code to fix the bug in server.ts” | Delegates to Claude Code agent |
| “Spawn a Codex agent to refactor this module” | Delegates to Codex |
| “Check on my coding agent” | Gets agent status |
| “Cancel the coding agent” | Aborts the agent |
Configuration
- Supports multiple external agents (Claude Code, Codex, Gemini CLI)
- Agents run as separate processes with their own context
- Status tracking: pending, running, completed, failed, aborted
Tips & gotchas
- Fully independent. ACP agents are separate processes with their own context window and tools.
- Self-contained tasks. Best for tasks like fixing a bug, refactoring a file, or writing tests.
- Coordinated results. Your assistant coordinates with the agent and reports back results.
- Choose the right agent. Claude Code for general development, Codex for code generation, Gemini CLI for Google ecosystem integration.