graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
ACP Registry listing (#613)
Listing is not a feature of this repo. The catalog lives in
agentclientprotocol/registry
and is what Zed's "Install from Registry" (and other ACP clients) reads.
This page is the submit recipe. There is no registry client in graff, and
graff acp does not grow one.
Hand-written Zed setup is graff acp (see the README)
and the host recipe stays embedding.md. Replace those with
"Install from Registry" only after a listing lands.
What already ships here
| Piece | Status |
|---|---|
graff acp stdio agent |
Shipped. Protocol version 1. |
Mid-turn session/update (thought / tool / text) |
Shipped (ADR 0032, #612). |
| Provider login | graff login / keychain / env keys. Not ACP authenticate. |
initialize.authMethods |
Shipped. graff-login / type: "terminal" / args: ["login"]. authenticate stays unused — the client re-spawns graff login. |
| Credential-free startup | Shipped. A clean graff acp initializes, then returns ACP auth_required until login and respawn. |
session/load |
Live CLI restores saved conversations in the selected workspace and replays retained history. |
session/request_permission |
Interactive clients answer tool approval requests; unattended --yolo remains available. See client behavior. |
A stale comment on #613 said #612 was still open. It is not: streaming is on the tagged v0.0.279 cut. The final in-repo registry prerequisite was startup ordering: key resolution used to exit before a clean process could initialize.
Registry auth
The registry's AUTHENTICATION.md accepts only:
- Agent Auth — the agent runs OAuth (local callback server + browser).
- Terminal Auth — the client re-spawns the binary with setup args (a TUI login), then runs the normal ACP command.
graff login is already Terminal Auth in product terms. initialize now
advertises it:
{
"authMethods": [
{
"id": "graff-login",
"name": "graff login",
"description": "Interactive terminal login (codegraff / Codex / Kimi)",
"type": "terminal",
"args": ["login"]
}
]
}
Do not invent Agent Auth that duplicates graff login. Do not add env-var
auth to satisfy the registry — it is not one of the two accepted types.
When startup finds no provider credential, the lightweight ACP loop uses the
same acp_engine initialize response as the full runtime. Requests that need
a live Agent are rejected without exiting the loop:
{"jsonrpc":"2.0","id":2,"error":{"code":-32000,"message":"Authentication required: run `graff login`, then restart the ACP agent."}}
CI on the registry repo runs
python3 .github/workflows/verify_agents.py --auth-check and rejects an
agent whose initialize omits authMethods.
Submit recipe (other repo)
- Fork
agentclientprotocol/registry. - Add a directory whose name equals
id(suggested:graff/). - Put
agent.json(schema: agent.schema.json) and a 16×16 monochromeicon.svgthat uses onlycurrentColor/none/inheritfills. Hardcoded colors fail CI. - Open a PR there. Versions must be pinned (no
/latest/, no@latest). GitHub Releases + arepositoryURL let the registry bump the tag hourly.
Draft agent.json for the next cut that advertises Terminal Auth (URLs and
sha256 must match a real release; do not submit against /latest/):
{
"id": "graff",
"name": "graff",
"version": "0.0.279",
"description": "Codegraff harness as an ACP agent (graff acp)",
"repository": "https://github.com/justrach/codegraff",
"website": "https://codegraff.com",
"authors": ["Rach Pradhan"],
"license": "LicenseRef-codegraff",
"distribution": {
"binary": {
"darwin-aarch64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-macos.tar.gz",
"cmd": "./graff",
"args": ["acp"]
},
"darwin-x86_64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-macos.tar.gz",
"cmd": "./graff",
"args": ["acp"]
},
"linux-aarch64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-linux.tar.gz",
"cmd": "./graff",
"args": ["acp"]
},
"linux-x86_64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-linux.tar.gz",
"cmd": "./graff",
"args": ["acp"]
},
"windows-aarch64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-windows.tar.gz",
"cmd": "./graff.exe",
"args": ["acp"]
},
"windows-x86_64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-windows.tar.gz",
"cmd": "./graff.exe",
"args": ["acp"]
}
}
}
}
Pin sha256 from that release's SHA256SUMS before the PR. Archive layout
is sometimes flat (graff at the tarball root) and sometimes nested
(graff-<target>/graff); cmd must match what the installer extracts.
authMethods and the credential-free handshake are on the wire. Pin sha256
from a real release, then open the registry PR in the other repo. This repo
still does not fetch the catalog.
Not this repo
- No
graff registrycommand. - No fetch of
cdn.agentclientprotocol.com. - No
authenticateimplementation (Terminal Auth is out of band).