Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python
5.0 KB
Raw Blame

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
  • workspace switch could star the wrong tree and report a stale cwd
  • a Codex WS type:error could leave a dead socket and an unbounded diagnostic
  • TUI steer / /btw dropped 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.