One runtime to launch any ACP agent, including Copilot, Claude, Codex, Gemini, Qwen, and OpenCode. Windows-safe process startup, auth retries, and streaming events handled.
npm install @acp-kit/core
import { runOneShotPrompt, onRuntimeEvent } from "@acp-kit/core";
for await (const event of runOneShotPrompt({
profile: "claude",
cwd: process.cwd(),
prompt: "Write a demo for this repo"
})) {
onRuntimeEvent(event, {
messageDelta: (e) => process.stdout.write(e.delta),
toolStart: (e) => console.log("→ tool", e.title),
toolEnd: (e) => console.log(" status", e.status),
});
}The official ACP SDK gives you protocol types. ACP Kit gives you the runtime around them — spawning local binaries or non-interactive npx fallbacks, completing the handshake, retrying auth, and keeping the connection healthy.
Subscribe to normalized events for application code, or iterate the raw protocol stream for protocol-faithful integrations. Same session, two views, no glue code.
File access, terminals, permission prompts — advertise only what your product can actually deliver. ACP Kit negotiates the right capability set with the agent automatically.
Spawn errors, auth errors, and protocol errors arrive with the context you need to tell misconfigured from missing — no log spelunking required.