convez.ai
Agente
lucascouts

claude-agent-tui

lucascouts/claude-agent-tui

Ver no GitHub
InicialPluginScore · de 0 a 100

ACP agent that drives the Claude Code subscription TUI over a PTY (Zed)

Instalação

$npx convez-ai lucascouts/claude-agent-tui

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 dias
Versão
v0.17.4
Issues abertas
0
Contribuidores
3

README

A tradução para o português deste README ainda está na fila.

claude-agent-tui

npm

An ACP-compatible agent that drives the Claude Code subscription TUI over a PTY, so your Claude Code threads render natively in Zed and other ACP clients.

Fork of @agentclientprotocol/claude-agent-acp v0.39.0. Where the upstream adapter calls the Claude Agent SDK, this fork spawns the claude subscription CLI in a pseudo-terminal and translates its JSONL transcript into ACP session/update notifications. See .fork-provenance.json for the exact fork point.

Why this exists

On June 15, 2026, Anthropic split Claude subscription billing into two pools: Anthropic's first-party tools (chat and the official Claude Code CLI) keep using your Pro/Max subscription, while third-party agents and SDK usage are billed separately at API rates — roughly 15–30× more expensive (separate monthly credits: $20 Pro / $100 Max 5x / $200 Max 20x).

In practice, Zed's built-in Claude integration now draws from those expensive third-party credits instead of your subscription. The official claude CLI/TUI, however, still runs on your subscription.

This project bridges the two: it drives the official Claude Code TUI over a PTY and exposes it through the ACP protocol, so Zed renders it as a native agent panel — giving you the full Claude Code experience inside Zed on your existing subscription, not API credits.

Not affiliated with or endorsed by Anthropic or Zed Industries. Use of the claude CLI remains subject to Anthropic's terms.

Requirements

  • The claude CLI (Claude Code subscription) available on your PATH.
  • Node.js ≥ 23 — the runtime and test suite use native TypeScript type-stripping.

Register in Zed

Build the agent, then point Zed's agent_servers at the built entrypoint:

// ~/.config/zed/settings.json
{
  "agent_servers": {
    "Claude Agent TUI": {
      "type": "custom",
      "command": "node",
      "args": ["/absolute/path/to/claude-agent-tui/dist/index.js"],
      "env": {},
    },
  },
}

Open the Agent Panel in Zed and select Claude Agent TUI.

Build & test

npm install
npm run build
npm test

Capabilities

  • Renders Claude Code threads: text, thinking, tool calls, structured diffs, TODO plans, and nested sub-agents
  • Token-usage updates
  • Prompt input, cancellation, and session load/replay

Supply-chain notes

Socket flags some dependency alerts (Native code, Install scripts, Shell access, plus heuristic flags on the Anthropic SDK tree). None are CVEs or malware — they are expected capability flags:

  • node-pty (the same PTY that powers VS Code) needs Native code / Install scripts / Shell access — driving the claude TUI in a real PTY is the whole point of this bridge.
  • The remaining flags come from the minified bundles inside @anthropic-ai/claude-agent-sdk, of which this fork uses only two pure, billing-free functions (getSessionMessages, resolveSettings).

All direct dependencies are first-party publishers (Microsoft, Anthropic, Zed).

License

Apache-2.0. This is a derivative work; original copyright belongs to Zed Industries and the Agent Client Protocol authors.

Ver o original no GitHub

Bom para

Relacionados