moabualruz

Claude Code CLI Acp — Development skill for Claude Code

Development community

ACP adapter for the real Claude Code CLI: Rust PTY bridge for Zed and other Agent Client Protocol clients.

How to install Claude Code CLI Acp

This entry records only its repository, not the path inside it, so there is no exact command to give. Open moabualruz/claude-code-cli-acp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code CLI Acp does

ACP adapter for the real Claude Code CLI: Rust PTY bridge for Zed and other Agent Client Protocol clients.

Alternatives in Development

  • OpenAI Codex CLI — (Rust implementation) 67.8k ★
  • Hive — Browser-native hive-mind for CLI coding agents — Claude Code, Codex, Gemini, and OpenCode collaborate as real 473 ★
  • Acp Go SDK — Go SDK for the Agent Client Protocol (ACP), offering typed requests, responses, and helpers so Go applications 226 ★

README

claude-code-cli-acp

ACP adapter for the real interactive [Claude Code CLI](https://code.claude.com/docs/en/cli-reference).

The adapter runs `claude` through a PTY, reads Claude transcript JSONL for canonical content, and exposes an [Agent Client Protocol](https://agentclientprotocol.com/) server for editors. It also keeps a direct `interactive` pass-through mode and a `print` mode that replaces `claude -p` by using the interactive CLI path.

Install

Prerequisites:

  • Install and authenticate Claude Code: npm install -g @anthropic-ai/claude-code, then run claude.
  • Use Node 18+ for the npm wrapper.
  • Use Rust 1.95+ when building from source.

Recommended install after npm publication:

npm install -g claude-code-cli-acp
claude-code-cli-acp doctor

Other supported install paths:

cargo install claude-code-cli-acp --locked
cargo install --git https://github.com/moabualruz/claude-code-cli-acp --locked
cargo install --path . --locked

Direct GitHub release archives and future Homebrew tap setup are documented in [docs/install.md](docs/install.md).

ACP Setup

Configure any ACP-compatible client to run:

claude-code-cli-acp

The ACP server speaks JSON-RPC over stdio. Editor clients must launch it as a local agent process, not through a shell that writes prompts or banners to stdout.

Zed setup details live in [docs/editor-setup.md](docs/editor-setup.md).

Zed supports registry-installed external agents and manual custom agents. This adapter can be used manually today through Zed `agent_servers`, and the ACP Registry publishing checklist is documented in [docs/publishing.md](docs/publishing.md).

CLI Modes

Interactive pass-through:

claude-code-cli-acp interactive -- --model sonnet

Default no-handshake invocation behaves like interactive pass-through, but do not alias over `claude`; that name belongs to the installed Claude Code CLI. If you want a shortcut, use a non-conflicting name:

alias claude-acp='clau