graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
v0.0.280 (2026-08-28)
Next cut after tagged v0.0.279 (70a5228). Everything that
missed that tag — the #645 continuation already on main, plus the
#646–#649 leftovers that kept accumulating on release/v0.0.279 — lives
here, plus TUI ACP (ADR 0041) and the grok-build pager inset.
279 stays published as-is. This is not a retag.
Already on main via #645
Tab titles use the live session provider/model (no extra chat remap;
Responses-kind errors name the provider, not "codex"). Same-process embed
is libgraff + graff-core.wasm + @codegraff/sdk/embed createGraffAgent()
(ADR 0038): ACP handshake in-process, first-slice turn is echo:. Live
coding stays graff acp. --experiment N / /experiment pre-mints a
child worktree pool (ADR 0037).
Experiment pool leftovers (#647 / #629)
Forced fan-out: the root must spawn. graff worktree list tags pool trees.
Worker results deliver the kept branch, path, and diffstat back. Trees are
never auto-deleted. Still opt-in.
TUI leftovers (#646 / #549) and Anthropic output_config (#550)
Stall HUD, TTY resize, MCP config polish. Native Anthropic structured
output uses output_config.format json_schema; tool-mode stays the
fallback.
Peer mailbox in the TUI (#648 / #563)
/tell and /peek use the existing peer mailbox (tui_peer). No second
channel.
ACP terminal auth, local tools, schedule, channel workers (#649)
graff acp initialize advertises graff-login (type: "terminal",
args: ["login"]). Clients without a terminal get no unusable method.
authenticate stays unused — the client re-spawns graff login. ACP
Registry listing still needs a PR on agentclientprotocol/registry;
leave #613 open.
Agent-authored local tools are project scripts under .graff/tools/
(install_agent_tool, local__<name>, --dry-run). Skills stay
instructions (ADR 0039).
.graff/schedule/<id>.json plus schedule_task / /schedule 5m …, with
due-claim and a TUI idle wake. /loop stays standing-goal.
Channel workers speak JSONL (outbox + wake only). Inbound
{"type":"message","text"}; /adapter send emits {"type":"send","text"}.
No Discord/Slack adapter in this cut.
Native codedb stays the reader (ADR 0040 / #652)
A licensed codedb-pro suite no longer hides or refuses native codedb
or read_file. Ordinary reads — including rlm codedb — use those
tools. Do not send everyday files through mcp__codedbpro__read. Pro
is extra search (faster_search, meta_search) when codedb cannot
answer. Leading shell grep/rg may still point at zigrep.
TUI is an in-process ACP client (ADR 0041)
graff tui speaks initialize / session/new / prompt / cancel through
acp_engine. Thought, tools, and answer text render from session/update
the same way Zed and the native app do. No child graff acp — one Agent
and the existing ReplCtx turn. Meters, notices, and raw bash stay on
tui_sink.
Pager inset (grok-build)
Transcript rows, the composer, and the footer sit off the terminal edges
(outer_hpad 2/2, outer_vpad 1; compact drops to min hpad 1 and no vpad).
Overlay panels stay full-width and docked.
Parked
yxlyx doctor / cube / governed / localhost stay inventory in yxlyx-leftovers.md. No new product mode.
Tests
The continuation raises the release-cut floor to 1745 (slack 25).
Downloads
All six CLI archives, the curl installer, and checksums:
| File | Platform |
|---|---|
| graff-aarch64-linux.tar.gz | Linux arm64 |
| graff-aarch64-macos.tar.gz | macOS Apple Silicon — Developer ID signed, Apple notarized |
| graff-aarch64-windows.tar.gz | Windows arm64 |
| graff-x86_64-linux.tar.gz | Linux x86_64 |
| graff-x86_64-macos.tar.gz | macOS Intel — Developer ID signed, Apple notarized |
| graff-x86_64-windows.tar.gz | Windows x86_64 |
| install.sh | curl installer |
| SHA256SUMS | checksums for the six archives |
curl -fsSL https://github.com/justrach/codegraff/releases/download/v0.0.280/install.sh | bash
Both macOS binaries are Developer ID Application signed (hardened runtime,
timestamped) and Apple notarized (notary-local, Accepted:
191ec047-50da-4c91-ad77-274be95a560d aarch64,
4b51338a-f8f3-49e0-b6e0-9aa5402ffdac x86_64). Stapling is skipped on
the bare CLI (stapler error 73); Gatekeeper checks the ticket online at
first launch. GitHub also attaches the usual source zip/tarball for the tag.