ACP adapter for Claude Code

Fork of @zed-industries/claude-code-acp

This fork adds support for subagent (Task tool) tracking and will soon include AskUserQuestion tool support.

Use Claude Code from ACP-compatible clients such as Zed!

Installation

npm i @finityno/claude-code-acp

Or install globally:

npm i -g @finityno/claude-code-acp

Features

This adapter implements an ACP agent using the official Claude Agent SDK:

• Context @-mentions
• Images
• Tool calls (with permission requests)
• Following
• Edit review
• TODO lists
• Interactive (and background) terminals
• Custom Slash commands
• Client MCP servers
• Subagent tracking (Task tool lifecycle events)

Subagent Tracking

Track Task tool (subagent) lifecycle events:

import { ClaudeAcpAgent } from "@finityno/claude-code-acp";

const agent = new ClaudeAcpAgent(client);
const tracker = agent.subagentTracker;

// Listen for subagent events
tracker.addEventListener("subagent_started", (subagent) => {
  console.log(`Started: ${subagent.description} (${subagent.subagentType})`);
});

tracker.addEventListener("subagent_completed", (subagent) => {
  console.log(`Completed: ${subagent.id}`);
});

tracker.addEventListener("subagent_failed", (subagent) => {
  console.error(`Failed: ${subagent.error}`);
});

// Query subagents
tracker.getRunningSubagents();          // Currently active
tracker.getSessionSubagents(sessionId); // By session
tracker.getStats();                     // Counts & avg duration

See docs/subagent-tracking.md for full API documentation.

Usage

With Zed

The latest version of Zed can use this adapter out of the box. Open the Agent Panel and click "New Claude Code Thread" from the + button menu.

Read the docs on External Agent support.

Other Clients

Use with any ACP compatible client:

ANTHROPIC_API_KEY=sk-... claude-code-acp

License

Apache-2.0