codegraff v0.2.16

codegraff v0.2.16

Released 2026-06-03

A fast follow-up to v0.2.15 that fixes two rough edges in the context stack
that release introduced, and ships the macOS desktop app (signed +
notarized) for the first time.

Fixes

@-mentioning a PDF/binary no longer errors

v0.2.15 tried to reflect a binary @-mention as a file reference, but it gated
that on a null-byte binary check while the file reader rejects binaries with
a magic-number (infer) check. The two disagree on files with an ASCII
header — a PDF's %PDF-1.x bytes have no null bytes — so the mention fell
through to the UTF-8 reader and still failed with "Binary files are not
supported. File detected as application/pdf".

Now a non-text/non-image @-mention resolves to the bare absolute path (plain
text, as if you had typed it). The agent treats it like any path and opens it
with the read tool, which already handles PDFs and images. The attachment path
also catches the reader's binary rejection directly, so the two detectors can no
longer disagree their way into an error.

Tool-result offload no longer fights the prompt cache

v0.2.15's lossless tool-result offload ran every turn unconditionally,
rewriting older tool-result messages in place (full → [offloaded] marker).
Because the prompt cache is prefix-based, rewriting a message before the kept
window broke the cache there and forced the whole keep-window to be reprocessed
at full (uncached) price every turn — roughly a 10× cost bump on the large
MCP/codedb results offloading was meant to save, and it fired even at trivial
context usage (e.g. 16k/180k).

Offloading is now gated on real context pressure (≥80% of the lossy
summarization threshold). Below that, the warm prefix cache is worth far more
than the few KB offloading would reclaim, so the context is left untouched and
the cache stays intact; offloading only kicks in as you approach the
summarization point — exactly when the cache would churn anyway.

Desktop app (macOS)

The Codegraff desktop app — a Tauri GUI with first-class slash commands,
contributed by @pranavp311 — is now available as a signed and notarized, universal (arm64 + x86_64) macOS build. It runs on the same core as the CLI/TUI.

Contributors

• @pranavp311 — the Tauri desktop app (feat(gui): add Tauri desktop app,
  Add desktop slash commands) and the macOS GUI it's built from.

Install

curl -fsSL https://github.com/justrach/codegraff/releases/latest/download/install.sh | sh

Pin this version with sh install.sh v0.2.16. macOS graff/codegraff binaries
are codesigned with a Developer ID Application certificate (hardened runtime) and
notarized by Apple; the CLI ships for macOS (arm64 + x86_64), Linux
(gnu/musl × x86_64/aarch64), Windows (x86_64/aarch64), and Android (graff). The
desktop app .dmg is a notarized Apple-Silicon (arm64) build.

Upgrade notes

• Non-breaking patch over v0.2.15; configuration and credentials carry over.
• The macOS build/notarization runbook lives at
  docs/releases/macos-build-and-notarize.md.