whatisgithub

What is claude-code-cli-acp?

moabualruz/claude-code-cli-acp — explained in plain English

Analysis updated 2026-05-18

3RustAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A Rust adapter that lets code editors like Zed talk to the Claude Code CLI using the Agent Client Protocol standard.

Mindmap

mindmap
  root((repo))
    What it does
      Bridges Claude Code CLI
      Speaks ACP protocol
      Runs CLI in PTY
    Tech stack
      Rust
      JSON-RPC
      Cargo
    Use cases
      Zed editor integration
      Custom ACP clients
    Audience
      Editor developers
      Claude Code users
    Setup
      Needs Claude Code CLI
      Needs Node or Rust
    Notes
      Security minded
      Apache-2.0 licensed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Connect the Zed editor to Claude Code CLI through a standard protocol.

USE CASE 2

Build a custom ACP client that talks to Claude Code CLI.

USE CASE 3

Replace scripted claude -p calls with a more reliable interactive bridge.

What is it built with?

RustCargoNode.jsJSON-RPC

How does it compare?

moabualruz/claude-code-cli-acpcodeitlikemiley/antigravity-sdk-rustdedsec-xu/needle
Stars333
LanguageRustRustRust
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Claude Code CLI already installed and authenticated first.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

So what is it?

claude-code-cli-acp is a Rust program that connects the Claude Code CLI, Anthropic's command line AI coding assistant, to code editors that support the Agent Client Protocol, known as ACP. The README specifically mentions Zed as a supported editor, though other ACP compatible clients could work too. The core problem it solves is bridging two different interfaces. Claude Code CLI is normally used interactively in a terminal. This adapter runs that CLI inside a pseudo terminal, reads the transcript files Claude Code writes in JSONL format, and turns that into a JSON-RPC server over standard input and output that editors can talk to using the ACP standard. It also offers a direct interactive pass-through mode and a print mode meant to replace the claude -p command by reusing the same interactive CLI path underneath. To install it, you first need Claude Code CLI itself installed and authenticated through npm, plus Node 18 or newer for the npm wrapper, or Rust 1.95 or newer if building from source. The tool itself can then be installed through npm, through Cargo from crates.io or directly from the GitHub repository, or built locally from the source path. Once installed, an ACP compatible editor is configured to launch the adapter as a local process, it communicates over JSON-RPC and should not run behind a shell that prints extra banners or prompts. Beyond the core bridge, the project includes a doctor command that checks installation health and can compare local Claude CLI behavior against a compatibility matrix to catch drift as Claude Code changes. It also treats Claude's transcript files as sensitive, since they are stored as plain text under a hidden folder in the user's home directory, and takes care not to log that text by default. The project is licensed under Apache-2.0, and credits several related projects, including Zed's own codex-acp adapter and the wider ACP and Rust SDK ecosystem, as inspiration.

Copy-paste prompts

Prompt 1
Help me install claude-code-cli-acp and configure Zed to use it as an agent server.
Prompt 2
Explain how the doctor command in claude-code-cli-acp checks for compatibility drift.
Prompt 3
Walk me through building claude-code-cli-acp from source with Cargo.
Prompt 4
Show me how to use the print mode of claude-code-cli-acp to get transcript output from a script.

Frequently asked questions

What is claude-code-cli-acp?

A Rust adapter that lets code editors like Zed talk to the Claude Code CLI using the Agent Client Protocol standard.

What language is claude-code-cli-acp written in?

Mainly Rust. The stack also includes Rust, Cargo, Node.js.

What license does claude-code-cli-acp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is claude-code-cli-acp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-code-cli-acp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.