acp-commons

Third nested atlas in the family. Navigates the protocol-substrate layer of the Para-mensch atom: which ACP client / agent surface carries a given Para(Optic) interaction.

• repl-commons — runtime-substrate (which REPL backend?)
• para-mensch-commons — categorical-substrate (which Para(Optic) instantiation?)
• acp-commons (this skill) — protocol-substrate (which ACP client × CapTP wire?)

The atom in protocol form

                client                agent
              ┌────────┐            ┌──────────┐
       ε ────►│        │  prompt    │          │
   user input │  Para- │ ─────────► │  agent   │── tool → S (FS/PTY/MCP)
              │ mensch │            │ subproc  │     │
       T ◄────│  port  │  stream    │          │ ◄───┘ residual M
              │        │ ◄───────── │          │       (audit, GF(3) trit)
              └────────┘            └──────────┘
                  │                       ▲
                  └──── parameter P ──────┘
                  (session id, sturdy ref, capabilities)

Play (▷) = forward prompt → tool calls. Witness (◇) = streamed plan/thought/tool-update audit + permission UI's declared loss. Coplay (◁) = parameter feedback through session/permission updates and BCom-style updates over CapTP.

Tier 1 — reference / production-grade clients

Zed

Native ACP IDE loop (not sidecar). Reference editor client. ACP traffic is a first-class buffer-and-action surface.

Toad (Python original)

Local clone at /tmp/batrachianai-toad/. Terminal-native ACP workbench: PTY + ACP subprocess + session lifecycle + SQLite persistence + permission UI + concurrent sessions + diffs. Key files: src/toad/acp/agent.py:1, src/toad/widgets/conversation.py:264, src/toad/widgets/terminal_tool.py:1. Furthest unique = terminal-native ACP workbench.

Zoad (Zig port)

Local at /Users/bob/i/zoad/. Pixel-perfect Zig 0.16.0-dev reimplementation of Toad. 1772 LOC, builds clean, no deps. Modules: src/{main,style}.zig (713 LOC) + src/acp/{protocol,jsonrpc,agent}.zig (795 LOC; agent.zig:AgentState is the 8-state ACP residual FSM) + src/widgets/{throbber,conversation,sidebar,prompt}.zig (977 LOC). Mach-O arm64 binary at zig-out/bin/zoad. NOT under git. Embedded variant in /Users/bob/i/zig-syrup/src/zoad.zig (693 LOC) uses retty + Syrup transport + notcurses; positions Zoad as a Plurigrid Human Vat holding SturdyRefs.

VS Code ACP Client

Full FS / terminal / permissions + traffic logging. Furthest unique = ACP-traffic debug visibility.

JetBrains AI Assistant ACP

~/.jetbrains/acp.json subprocess agents + IDEA MCP bridging. Furthest unique = ACP+MCP tool governance.

Tier 2 — distinctive surface

• Jockey — multi-agent orchestrator (Claude Code + Gemini CLI + Codex CLI). Client-as-scheduler.
• SuperQode — agentic coding product.
• Neovim — CodeCompanion, agentic.nvim, avante.nvim — modal/editor composability.
• AionUi / aizen / DeepChat / Tidewave — reusable app/browser ACP frontends.
• marimo / agent-client-kernel / DuckDB sidequery ACP — notebook/dataframe/db substrate.

Tier 3 — niche / extensibility

• Emacs — agent-shell.el / acp.el — Lisp-extensible ACP workflows.
• Obsidian Agent Client / Minion Mind — note-graph/vault context.
• Unity ACP / Unity Agent Client — game-editor scene context.
• Long-tail: Chrome ACP / acpx / gemini-cli-desktop / Agent Studio / iflow-cli / Lody / Mitto / Nori CLI / Ngent / RayClaw / RLM Code.
• Mobile: Agmente / Ferngeist / Happy / Mobvibe.
• Messaging: ACP Discord, duckdb-claude-slack, Juan, OpenACP, Telegram ACP Bot, Telegram-ACP, WeChat ACP.

ACP-over-CapTP (the OCapN bridge)

ACP-as-prompt-stream wraps cleanly over CapTP-as-cap-passing. The translation:

ACP	CapTP / OCapN
session id	sturdy ref
permission grant	bcom-style attestation
tool call	message-pass to a sealed reference
MCP server	far-vat with restricted promise pipelining
agent subprocess	spawned vat with its own gc

Local skills carrying this bridge:

teglon-acp · captp · goblins · goblins-adapter · guile-goblins-hoot · wasm-goblins · openclaw-goblins-adapter · universal-captp-derivation · google-cloud-ocapn-vats · syrup · zig-syrup-propagator-interleave · shadow-goblin · dynamic-sufficiency-goblin

Primary entries: captp (wire), goblins (vat runtime), universal-captp-derivation (constructive proof of the bridge), teglon-acp (the Plurigrid-side ACP), toad-telemetry (run-time audit of an ACP session).

Hermes-as-OCapN-actor (planned)

The 12-skill hermes-* family stages an LLM agent's standard tools (fs, net, mcp, mem, tool, cron, cred, session, approval, ctx-engine) as sealed CapTP capabilities:

• hermes-acp-over-captp — the bridge proper
• hermes-fs-as-cap, hermes-net-as-cap, hermes-tool-as-cap, hermes-mcp-as-sealed
• hermes-mem-as-dataspace, hermes-cron-as-dataspace
• hermes-approval-as-revocable, hermes-cred-as-sturdy
• hermes-session-as-snapshot, hermes-ctx-engine-shim, hermes-goblins-bridge

Currently a WIP family (untracked on wev-hodge-decomp). Once landed, the pattern hermes-* adds them all to this hub in one edit.

Frameworks (NOT clients)

AgentPool · fast-agent-acp · Koog · LangChain/LangGraph Deep Agents ACP · LlamaIndex workflows-acp · LLMling-Agent · AgentRQ · Aptove Bridge · OpenClaw bridge · stdio Bus. fast-agent has unusually complete ACP feature coverage but is agent/framework-side. openclaw-goblins-adapter is the local OpenClaw bridge skill.

yb-translator parable for ACP

CONCEPT: ACP-over-CapTP bridge
BIOLOGY: hormone-receptor signaling with cAMP second messenger
ONTOLOGY: GO — signal transduction (GO:0007165),
          G protein-coupled receptor signaling pathway (GO:0007186)
EXAMPLE: ACP session-id ≡ ligand binding event;
         CapTP sturdy-ref ≡ activated GαS;
         ACP tool-stream ≡ cAMP-amplified PKA cascade;
         agent gc ≡ phosphodiesterase-mediated cAMP hydrolysis

The 23-row Para-mensch table maps cleanly through ACP — every domain can be mounted as an ACP agent whose tool surface is the substrate-bearer. yb-translator's coalgebra coherence guarantees that re-mounting the same domain over ACP preserves the GF(3) trit.

Use when

• Picking which ACP client to host an interaction in
• Bridging an ACP session through CapTP (sealed capability piping)
• Locating the local Zig ACP implementation (Zoad)
• Planning Hermes-style "agent-tool-as-sealed-cap" architecture
• Wrapping an existing skill from repl-commons or para-mensch-commons as an ACP agent

Related atlases

• REPL atlas (runtime): repl-commons
• Para(Optic) atlas (categorical): para-mensch-commons
• ACP atlas (protocol): this skill