graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
v0.0.285 (2026-09-03)
Next cut after v0.0.284. The headline is the native app behaving like a chat you can actually read: scrolling up while the agent is writing no longer yanks the transcript, follow-ups typed during a turn queue instead of vanishing, and tool rows land in the answer instead of as a wall on top.
284 stays published as-is. This is not a retag.
What this cut is
graff is still one static Zig binary that turns the AI subscriptions you
already pay for into an agent on your machine — same Agent type on the
line REPL, the fullscreen TUI, graff acp, and the native GUI. 285
closes the gaps those surfaces hit after the 284 tag:
- scrolling the native transcript during a stream was impossible — every token pinned the viewport to the tail
- sending a follow-up while a turn was running was a no-op
- tool chips rendered as a stack above the answer
workspaceswitch could star the wrong tree and report a stale cwd- a Codex WS
type:errorcould leave a dead socket and an unbounded diagnostic - TUI steer /
/btwdropped composer image chips - the TUI hid the live answer behind a Thinking placeholder
Those are all closed.
Scroll away while it writes (#724)
The native thread followed the tail with a large near-bottom magnet, so
a short scroll never escaped — the next token jumped you back. Follow
now pins only while the reader is actually at the tail. Scrolling up
pauses it; returning to the bottom resumes. The pin uses the scroller
offset, not scrollIntoView (that realigned the whole WKWebView every
frame).
Queue a follow-up while a turn is running
The composer stayed disabled for the whole turn, so the next prompt was dropped. It now stays open. Enter with text queues the line (shown above the bar, removable). Queued prompts drain in order when the turn ends. An empty draft still shows stop.
Tools in the answer, not a wall on top
Tool chips and text now follow the wire order instead of dumping every tool first. Settled batches fold; the live row stays open. ACP patches coalesce to one paint per frame so a long thread does not re-parse every settled markdown block on each token.
Workspace switch reports the process cwd (#721)
workspace could star a tree the process had not entered, and the
status line could disagree with cwd. Switch now compares real paths and
reports the process cwd after enter.
Codex WS error-frame recovery (#717)
#692 / #693 already treat a generic WebSocket type:error as a
terminal API response. Three edges were still loose: the transport kept
the dead socket, chain recovery keyed off a retained id even when the
body omitted previous_response_id, and an unparseable envelope could
copy raw bytes into last_api_error. The socket now closes on the
error frame; re-anchor requires the rejected body to contain
previous_response_id and a recognized chain error; unparseable bodies
use the same bounded diagnostic as structured provider failures.
TUI steer carries image chips
A follow-up typed while a turn is running (Enter to queue, or /btw)
used to copy only the typed text, so composer chips never reached the
next turn. Queueing now prefixes the same @[path] markers a normal
send uses. An image-only Enter queues the chip instead of treating
empty text as interrupt.
TUI live answer
While tokens arrive, the TUI shows the live answer instead of a
Thinking placeholder. codedb rows fold as “Looked up N items”.
Tests
Suite floor is 1909. Native follow-tail and prompt-queue helpers
are covered in the native unit suite. This fold also adds the #717
re-anchor case (rejected body must have sent previous_response_id).
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 |
| graff-aarch64-windows.tar.gz | Windows arm64 |
| graff-x86_64-linux.tar.gz | Linux x86_64 |
| graff-x86_64-macos.tar.gz | macOS Intel |
| 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.285/install.sh | bash
GitHub also attaches the usual source zip/tarball for the tag.