migrate-claude-sdk-to-acp

Install

claude plugin marketplace add LivioGama/migrate-claude-sdk-to-acp
claude plugin install migrate-claude-sdk-to-acp

That's it. The skill auto-activates when you ask Claude Code about migrating from the CLI, the Agent SDK, or subprocess patterns.

One-session usage without installing: claude --plugin-dir /path/to/migrate-claude-sdk-to-acp

Why ACP?

With claude -p, every call spawns a new process — startup, authentication, initialization, then exit. If you're sending multiple prompts from code, you pay that overhead every time.

ACP (Agent Client Protocol) keeps a single long-lived process. Sessions stay in memory. Send as many prompts as you want without re-spawning.

claude -p:   spawn → init → auth → prompt → exit → spawn → init → auth → prompt → exit
ACP:         spawn → init → auth → prompt → prompt → prompt → prompt → ...

Measured Performance

Benchmark: Haiku model, "say pong" × 5 sequential calls on Apple Silicon:

The per-call difference is modest (~15%) since most latency is the API round-trip. The real gains come at scale — at 50 calls, ACP is ~10% faster overall — and from architectural benefits: no API key management, conversation context preserved across turns, and mid-session control (model switching, interrupts, permission changes).

Note: claude -p with --continue/--resume and --output-format stream-json can achieve similar functionality. ACP's advantage is performance for multi-prompt workflows and a standardized protocol (JSON-RPC) instead of ad-hoc output parsing.

Demo

https://github.com/user-attachments/assets/0380ff65-2b6b-4192-895d-0deb29b4e19f

What You Get

The plugin provides complete, copy-paste ACP clients and migration guides for three languages:

const client = new AcpClient(cwd);
client.start();
await client.initialize();
await client.prompt('Refactor auth');
await client.prompt('Now add tests');

client := acp.NewClient(cwd)
client.Start(ctx)
client.Initialize()
client.Prompt("Refactor auth")
client.Prompt("Now add tests")

client = AcpClient(cwd)
client.start()
client.initialize()
client.prompt("Refactor auth")
client.prompt("Now add tests")

Each client includes:

• Full JSON-RPC protocol handling
• Streaming event parsing (thinking, text, tool calls, usage)
• Session persistence across prompts
• Cancellation support

A web visualizer is also included in assets/visualizer/ as inspiration for building your own streaming UI.

ACP Adapter