Skip to content

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

Python

Show current release highlights in beta and version output

Rach Pradhan5c485be471d0
diff --git a/.github/workflows/beta-release.yml b/.github/workflows/beta-release.yml
index 6bd61292..ffc6f5f4 100644
--- a/.github/workflows/beta-release.yml
+++ b/.github/workflows/beta-release.yml
@@ -131,6 +131,14 @@ jobs:
- name: Recheck release branch head
id: fresh
run: python3 scripts/beta-release.py guard --branch "$GITHUB_REF_NAME" --sha "$GITHUB_SHA"
+ - name: Prepare beta notes
+ if: steps.fresh.outputs.publish == 'true'
+ env:
+ BETA_TAG: ${{ needs.plan.outputs.tag }}
+ run: |
+ python3 scripts/beta-release.py notes \
+ --branch "$GITHUB_REF_NAME" --sha "$GITHUB_SHA" \
+ --tag "$BETA_TAG" --output beta-notes.md
- name: Publish beta prerelease
if: steps.fresh.outputs.publish == 'true'
env:
@@ -142,4 +150,4 @@ jobs:
test -f beta-assets/Codegraff-linux-amd64.deb
gh release create "$BETA_TAG" beta-assets/* \
--target "$GITHUB_SHA" --prerelease --latest=false \
- --title "$BETA_TAG" --notes 'Beta build from the latest release branch.'
+ --title "$BETA_TAG" --notes-file beta-notes.md
diff --git a/scripts/beta-release.py b/scripts/beta-release.py
index 61698179..af486264 100644
--- a/scripts/beta-release.py
+++ b/scripts/beta-release.py
@@ -3,6 +3,7 @@
import argparse
import os
+from pathlib import Path
import re
import subprocess
@@ -50,6 +51,31 @@ def plan(branch, sha, run_number, run_attempt, heads):
return {"version": version, "tag": f"v{version}"}
+def changelog_section(contents, tag):
+ """Return the body of one exact level-two release heading."""
+ lines = []
+ found = False
+ for line in contents.splitlines():
+ if line.startswith("## "):
+ if found:
+ break
+ found = line[3:].strip() == tag
+ elif found:
+ lines.append(line)
+ return "\n".join(lines).strip()
+
+
+def beta_notes(branch, sha, tag, changelog):
+ if version_key(branch) is None:
+ raise ValueError("Expected a release/vX.Y.Z or release/vX.Y.Z.W branch")
+ stable_tag = f"v{branch.removeprefix('release/v')}"
+ if not re.fullmatch(re.escape(stable_tag) + r"-beta\.\d+\.\d+", tag):
+ raise ValueError("Beta tag does not match the release branch")
+ context = f"Beta prerelease `{tag}` from `{branch}` at commit `{sha}`. This is not the stable release."
+ section = changelog_section(changelog, stable_tag)
+ return context + f"\n\n## Changes for {stable_tag}\n\n" + (section or "Release highlights are not yet listed for this version.") + "\n"
+
+
def write_output(values):
output = os.environ.get("GITHUB_OUTPUT")
if output:
@@ -59,12 +85,21 @@ def write_output(values):
def main():
parser = argparse.ArgumentParser()
- parser.add_argument("mode", choices=("plan", "guard"))
+ parser.add_argument("mode", choices=("plan", "guard", "notes"))
parser.add_argument("--branch", required=True)
parser.add_argument("--sha", required=True)
parser.add_argument("--run-number", type=int)
parser.add_argument("--run-attempt", type=int)
+ parser.add_argument("--tag")
+ parser.add_argument("--changelog", default="CHANGELOG.md")
+ parser.add_argument("--output")
args = parser.parse_args()
+ if args.mode == "notes":
+ if not args.tag or not args.output:
+ parser.error("notes requires --tag and --output")
+ contents = Path(args.changelog).read_text(encoding="utf-8") if Path(args.changelog).exists() else ""
+ Path(args.output).write_text(beta_notes(args.branch, args.sha, args.tag, contents), encoding="utf-8")
+ return
heads = remote_heads()
if args.mode == "guard":
fresh = current_beta(args.branch, args.sha, heads)
diff --git a/scripts/test-beta-release.py b/scripts/test-beta-release.py
index ac358fe8..1b826997 100644
--- a/scripts/test-beta-release.py
+++ b/scripts/test-beta-release.py
@@ -63,6 +63,8 @@ class BetaReleaseTests(unittest.TestCase):
self.assertEqual(stable_workflow.count("scripts/check-release-tag.py"), 2)
self.assertNotIn("install.sh", beta_workflow)
self.assertIn("--prerelease --latest=false", beta_workflow)
+ self.assertIn("scripts/beta-release.py notes", beta_workflow)
+ self.assertIn("--notes-file beta-notes.md", beta_workflow)
def test_stale_publication_is_a_clean_skip_but_remote_error_fails(self):
argv = ["beta-release.py", "guard", "--branch", "release/v0.0.302.4", "--sha", "old"]
@@ -76,6 +78,44 @@ class BetaReleaseTests(unittest.TestCase):
with self.assertRaises(subprocess.CalledProcessError):
beta.main()
+ def test_beta_notes_use_exact_release_section_and_preserve_source(self):
+ changelog = """# Changelog
+## v0.0.302.3
+Earlier notes.
+
+## v0.0.302.4
+
+### Changes
+- A current change.
+- Another current change.
+
+## v0.0.303
+Later notes.
+"""
+ notes = beta.beta_notes("release/v0.0.302.4", "a" * 40, "v0.0.302.4-beta.20.1", changelog)
+ self.assertIn("v0.0.302.4-beta.20.1", notes)
+ self.assertIn("release/v0.0.302.4", notes)
+ self.assertIn("`" + "a" * 40 + "`", notes)
+ self.assertIn("This is not the stable release.", notes)
+ self.assertIn("## Changes for v0.0.302.4", notes)
+ self.assertIn("### Changes\n- A current change.\n- Another current change.", notes)
+ self.assertNotIn("Earlier notes", notes)
+ self.assertNotIn("Later notes", notes)
+
+ def test_beta_notes_fall_back_for_missing_section_or_file(self):
+ branch, sha, tag = "release/v0.0.302.4", "b" * 40, "v0.0.302.4-beta.20.1"
+ self.assertIn("not yet listed", beta.beta_notes(branch, sha, tag, "## v0.0.302.3\nOlder"))
+ with tempfile.TemporaryDirectory() as directory:
+ output = pathlib.Path(directory) / "notes.md"
+ argv = ["beta-release.py", "notes", "--branch", branch, "--sha", sha,
+ "--tag", tag, "--changelog", str(pathlib.Path(directory) / "missing.md"),
+ "--output", str(output)]
+ with mock.patch.object(sys, "argv", argv), mock.patch.object(beta, "remote_heads", side_effect=AssertionError("network")):
+ beta.main()
+ self.assertIn("not yet listed", output.read_text())
+ with self.assertRaises(ValueError):
+ beta.beta_notes(branch, sha, "v0.0.303-beta.20.1", "")
+
if __name__ == "__main__":
unittest.main()
diff --git a/src/cli.zig b/src/cli.zig
index 894fab41..36fe339d 100644
--- a/src/cli.zig
+++ b/src/cli.zig
@@ -21,292 +21,14 @@ const version_status = @import("version_status.zig");
pub const changelog_text =
\\What's new
\\──────────
- \\0.0.297
- \\ • native tools keep moving while MCP connects; project MCP setup is clearer
- \\ • desktop turns preserve completed work; tabs combine and restore split layouts
- \\ • queued prompts support edits and attachment previews; drafts pause sending
- \\ • inline HTML explanations persist; codegraff opens projects from the terminal
- \\ • clipboard image reads and current-head PR verification are more reliable
- \\
- \\0.0.295
- \\ • GLM image follow-ups keep a caption so Chat Completions does not 400 (#812)
- \\ • codedb context is local by default; project layout listing stays broad
- \\ • citation control glyphs stripped; ACP cancel reaches the live turn
- \\ • mermaid fences render as diagrams; working agents show occupancy, talk, and Stop
- \\ • Updates settings: check now, auto-download on a six-hour poll
- \\
- \\0.0.294
- \\ • streaming stalls recover out loud: one bounded reconnect notice, honest trace regimes
- \\ • codex streams reasoning summaries; a fresh WS prewarms with generate:false before turn 1
- \\ • Responses WS frames drop the transport-only stream field (xAI spec)
- \\
- \\0.0.289
- \\ • background-agent handles survive an interrupted API turn (#753)
- \\ • prompt-cache affinity is the git root, not the leaf cwd
- \\ • Meta tool_choice is auto-only; error-only SSE is not a truncate-retry (#751 #748)
- \\ • worktree edits land on the selected root (#747)
- \\
- \\0.0.288
- \\ • GPT-6 Astra is the default Codex model: mid-turn steer, vision, hosted search, OpenAI compact
- \\ • Gemini is a first-class provider on Google's Interactions API
- \\ • recorded constraints ride the prefix as ledger JSON; recaps cannot invent them (#738)
- \\ • a second paste in the same batch no longer sends on its first newline (#737)
- \\ • truncated tool-call arguments cannot poison later requests (#752)
- \\ • a plain final with open work gets one reconciliation request (#745)
- \\ • native composer: real @ files, image paste and drop
- \\
- \\0.0.287
- \\ • the macOS app updates itself — verified signature, team and notarization before it installs
- \\ • native app gains a searchable, paginated conversation library (#723)
- \\ • one paste stays one prompt even when it spans several terminal reads (#737)
- \\ • rendered bare URLs no longer carry trailing ** into the click target (#729)
- \\ • workspace switch resolves paths without linking libc (#721)
- \\ • Codex websocket transport errors retire the socket (#717)
- \\ • outbound writes are sanitized by default; compaction can no longer invent constraints (#739, #738)
- \\
- \\0.0.286
- \\ • native harness gains a browser pane: a Chrome tab per chat, click an element to pin it for the agent
- \\ • split view — up to four chats side by side, each with its own model and folder (⌘D)
- \\ • tab names are written by the model from the first prompt
- \\ • saved chats can be archived or deleted from the sidebar
- \\ • ⌘T/⌘W/⇧⌘T open, close and reopen a chat with its session resumed
- \\ • picking a workspace moves the tab in front of you when it is empty
- \\ • the desktop shell ships as a signed, notarized macOS app
- \\
- \\0.0.285
- \\ • native transcript stays put when you scroll up mid-stream; return to the tail to follow again (#724)
- \\ • follow-ups typed while a turn is running queue and send when it ends
- \\ • native tools land in the answer, not as a wall on top; settled batches fold
- \\ • workspace switch stars and reports the process cwd (#721)
- \\ • Codex WS type:error retires the socket immediately; last_api_error stays bounded (#717)
- \\ • TUI steer / /btw queues composer image chips with the text, not text alone
- \\
- \\0.0.284
- \\ • ACP turns stage GUI @[image] attachments as native vision blocks — pasted images reach the model
- \\ • peer inbox wake is advisory ("parked; read when relevant"), never a command that displaces the turn
- \\ • parallel error bash results stay valid JSON on the next Codex request (#711)
- \\ • /resume and /sessions find ~/.graff/sessions, not just cwd (#712)
- \\ • named-source gate is per mention; identical user turns do not replay (#714)
- \\ • fullscreen /goal is retirable; completion no longer resumes stale steering (#716)
- \\
- \\0.0.283
- \\ • deleted composer image chips reuse #N; paste traces omit MIME/bytes until send (#702)
- \\ • peer_message addresses a live session by its visible title or saved-session base (#700)
- \\ • tuiguard fails a wedged PTY probe instead of hanging pre-push (#704)
- \\ • same-boundary compact_cut with no shrink stops after two tries (#706)
- \\ • credential replace fsyncs the POSIX directory after rename (#405)
- \\ • graff acp answers initialize and advertises graff-login before keys (#701)
- \\ • ESC ESC CSI Alt+arrow is one nav event — does not cancel (#524, #707)
- \\
- \\0.0.282
- \\ • pasted-text chips are atomic spans — a typed lookalike stays literal (#674)
- \\ • Codex WS type:error is a terminal API response; last_api_error stays (#693)
- \\ • request-construction TLS failure rotates a leased HTTP client generation (ADR 0048)
- \\ • --resume SOURCE --branch DEST is clone-on-write (ADR 0049)
- \\ • MCP HTTP/WSS reuse warmed TLS; catalogs can arrive gzip (ADR 0050)
- \\ • /teleport + /snapshot gc (ADR 0051); DeepSeek thinking off at low (ADR 0054)
- \\ • lean -p bounces prose-only done (ADR 0052) and backgrounds bash at 15s (ADR 0055)
- \\
- \\0.0.281
- \\ • -p / --json skip learn auto-init — no 132M graff-pinned copy (ADR 0044)
- \\ • SuperGrok SWE 5/6 in 205s / 6.5s CPU (was 4/6 in 456s / 230s)
- \\ • TUI claims alt-screen before boot; live markdown on the cached tail (ADR 0042)
- \\ • companion MCP queues in the background; mid-turn stalls stay off the transcript
- \\ • Codegraff SWE is not GLM-only: Gemini 5/6 in 103s; DeepSeek flash still one-shots (ADR 0047)
- \\
- \\0.0.280
- \\ • leftover 279 work: TUI stall/resize, experiment fan-out, /tell /peek, ACP graff-login
- \\ • local tools (.graff/tools), /schedule due-claim, JSONL channel workers
- \\ • native codedb / read_file stay the default readers; codedb-pro is extra search (ADR 0040)
- \\
- \\0.0.278
- \\ • deleted composer screenshots are not sent: submit keeps [Image #N] / @[path] only (#634)
- \\ • /image and /paste stay sticky; /image clear drops the whole queue
- \\ • TUI backspace / Ctrl+U / overlay backspace detaches chips
- \\ • Smolify is no longer a reserved core MCP; add it via `graff mcp add` if you want it
- \\
- \\0.0.277
- \\ • MCP-inside-rlm + learnt slim: fat MCP results drop to id/title; comments fold to n+latest_author (ADR 0029)
- \\ • L (warm slim, --no-lean) 14.8s/31k/5 vs H 28s/112k/7 on SuperGrok grok-4.6
- \\ • xAI Responses hosts x_search on grok-4.6 tools turns (ADR 0031); GRAFF_XAI_X_SEARCH=0 opts out
- \\ • rlm stays hidden on small turns; showcase at --rlm, a 4-wide native batch, or 50% of compactAt (ADR 0030)
- \\ • licensed codedb-pro is one read/search surface; Smolify is opt-in; turns pulse without a 16-call cap
- \\
- \\0.0.276
- \\ • rlm (RLM + mid-stream spec-ptc) is the default loop; --old / --no-rlm restores structured-only
- \\ • prompt-cache max: stable catalog is the default (loads no longer rewrite tools JSON); children share prefix lanes
- \\ • foreground bash auto-backgrounds after 120s instead of waiting forever (#620)
- \\ • Kimi identity: graff/<version> User-Agent; device headers match kimi-code (#617)
- \\ • Codex session_id header matches prompt_cache_key (openai/codex)
- \\ • Codex thinking silence uses the full stall budget; stall notice is honest
- \\ • REPL/TUI prints a dim line when a newer graff release is available
- \\
- \\0.0.275
- \\ • OpenRouter requests carry app attribution (categories: cli-agent, programming-app)
- \\ • TUI: Esc with a draft in the composer never kills a live turn
- \\ • agent: retry degenerate empty completions and keep-alive-only bodies
- \\
- \\0.0.274
- \\ • rate-limit retries no longer dump the provider's raw error JSON
- \\
- \\0.0.273
- \\ • long tool calls print a dim "still running" heartbeat instead of going quiet
- \\
- \\0.0.272
- \\ • Windows: line REPL prompt and graff-repl also use UTF-8, not only the TUI (#607)
- \\
- \\0.0.271
- \\ • Windows: TUI/REPL box-drawing is UTF-8 (CP 65001), not CP437 mojibake (#607)
- \\
- \\0.0.270
- \\ • OpenRouter (OPENROUTER_API_KEY → anthropic/claude-sonnet-4.6); live /models
- \\ • Windows: edit_file/write_file no longer panic on path chmod (#606)
- \\ • Line REPL transcript is the task, not the event bus
- \\ • TUI markdown: lists, quotes, tasks, rules, italic
- \\
- \\0.0.269
- \\ • Vercel AI Gateway (AI_GATEWAY_API_KEY → alibaba/qwen3.8-27b); coding-agent /v1
- \\ • Z.AI defaults to GLM-5.3 (1M); thinking.enabled + implicit prefix cache
- \\ • GLM Coding Plan: ZAI_CODING=1 / GRAFF_ZAI_URL; not image/video
- \\ • Line REPL tool rows are decisions; live bash is /debug-only
- \\
- \\0.0.268
- \\ • Cerebras Inference (CEREBRAS_API_KEY → gpt-oss-120b); not the WSE CSL SDK
- \\ • Codex-shaped .harness/agents/*.toml (and ~/.codex/agents) pin model/effort
- \\ • imagegen Codex engine: private config so exec no longer rejects JSON (#576)
- \\ • Live bash chunks + idle job notify + raw terminal (do not poll)
- \\ • ask_user pastes reach the model as vision blocks; compact keeps the live prompt's images
- \\
- \\0.0.267
- \\ • bash_output/agent_output wait_ms>0 blocks until exit (10h), not a 30s poll
- \\
- \\0.0.266
- \\ • In-place Cursor/Claude/Grok/Codex plugins (no cache walk; Codex via config.toml)
- \\ • Skill catalog is cache-stable: names + triggers, pinned once, no file: paths
- \\ • Peer inbox is pull; standing goal is one prefix line; workspace tool switches trees
- \\ • install.sh puts graff on PATH; long-horizon evals use external verifiers
- \\
- \\0.0.265
- \\ • TUI clicks work everywhere they look clickable; overlays are framed panels
- \\ • /models shows provider + cost badge; prices refresh from LiteLLM
- \\ • /snapshot attach|list and /rewind for a Docker sandbox seam
- \\
- \\0.0.263
- \\ • grok-4.6 is the xAI default: 500k window, published dual-band prices
- \\ • /effort low|medium|high|xhigh on native Grok (gateway grok-build still ignores it)
- \\ • Per-project prompt cache key survives a new session in the same cwd
- \\ • TUI: crash/suspend restore, in-app drag selection, SIGTSTP/quit livelock gone
- \\
- \\0.0.262
- \\ • Formal conformance corpus (Lean kernels + executable reference)
- \\ • TUI /compact runs the real engine compaction; mid-turn /new|/compact|/rewind refused
- \\
- \\0.0.261
- \\ • Grok-style TUI: syntax-highlighted fences, sticky prompt header, auto light/dark, flicker-free paints
- \\ • ~24 rendering/input fixes: phantom-Escape turn cancels, debris typed into the composer, bold bleed, emoji-bent borders, /theme half-repaints
- \\ • xAI KV-cache affinity headers + WebSocket 25-min limit handling
- \\
- \\0.0.260
- \\ • Fixed the composer wiping itself mid-typing after a Cmd+Tab (stale Super latch made Backspace act as Cmd+Backspace)
- \\
- \\0.0.259
- \\ • Grok defaults to xAI's Responses wire: WebSocket turns, lossless server-side compaction, structured outputs — no env needed (GRAFF_XAI_WIRE=chat opts out)
- \\ • Fixed duplicate MCP tool definitions that made strict Responses endpoints reject every turn
- \\
- \\0.0.258
- \\ • Full Grok on a SuperGrok sub: GRAFF_XAI_WIRE=responses gets server-side compaction (lossless blob), WebSocket turns, and --output-schema structured outputs
- \\ • /compact on the xAI wire uses the first-party endpoint; strict schemas run two-phase so they never suppress tool use
- \\ • Kitty keyboard overhaul: right-side modifiers fixed, no release double-fires, terminal state restored even on SIGTERM
- \\ • graff-evals: in-repo eval suite (12 tasks) with side-by-side harness comparison
- \\
- \\0.0.257
- \\ • Composer box aligns and wraps on words, not mid-letter
- \\
- \\0.0.256
- \\ • TUI swallows leftover Kitty CSI-u, types Shift+9 as (, logs stdin to .graff/tui-traj.jsonl
- \\
- \\0.0.255
- \\ • TUI no longer dumps mouse CSI (39;33;23M) into the thinking line
- \\
- \\0.0.254
- \\ • graff tui is a Grok-style fullscreen pager (composer wrap, tool fold, effort picker, markdown tables); bare graff stays the line REPL
- \\ • /import-claude copies Claude/Cursor MCP servers and skills into ~/.codegraff on first start or on demand
- \\
- \\0.0.253
- \\ • /compact uses first-party OpenAI compaction for direct API-key and Codex sessions, with transactional local fallback
- \\ • Kimi cache affinity plus concurrent catalogs and MCP startup remove avoidable serial latency
- \\ • @codegraff/sdk ships its platform binary and production Harness/Remote controls for npm embedding
- \\ • The REPL gains quiet normal output, /debug and read_file contains=; desktop agents move into focused control with new branding
- \\
- \\0.0.252
- \\ • Grok models come from a live api.x.ai /v1/models fetch every load — new rollouts no longer wait for a release
- \\ • SuperGrok OAuth tokens send X-XAI-Token-Auth like grok-build, so login sessions can actually call the API
- \\
- \\0.0.250
- \\ • First-party OpenAI compaction preserves the complete canonical compact output on both Codex subscription and official Platform Responses routes
- \\ • Invalid remote compaction falls back locally without mutating history; non-OpenAI providers remain local-only
- \\ • REPL tool calls use stable terse start/result rows with readable previews instead of raw JSON
- \\
- \\0.0.249
- \\ • Folded native tools become callable as soon as their schemas load; the active catalog now rebuilds instead of advertising unreachable tools
- \\ • Turn events and generated TypeScript SDKs expose cumulative input, output, cache-read, and cache-write token usage
- \\ • codedb-pro paths resolve from the active session worktree, and piped ask_user sessions end cleanly at EOF
- \\ • The default prompt carries a capped skills catalog, with concurrent interactive WebSocket tool loops covered by the release suite
- \\
- \\0.0.247
- \\ • Interactive startup is quiet by default; `GRAFF_REPL_DEBUG=1` restores launch and runtime diagnostics, and `/debug` still toggles them live
- \\ • Shared-worktree ownership is a structured callout with the active session, goal, and `graff -w` isolation action
- \\ • Immediate multiline pastes into `ask_user` preserve every line instead of submitting only the first
- \\
- \\0.0.244
- \\ • Co-resident graff sessions now see each other: a startup warning names any live session already in your worktree, and the first git mutation, file write, or shell move against a peer's tree pauses once for a deliberate re-issue — two agents can no longer silently tear one tree
- \\ • Sessions can message each other: peer_message posts to this folder's room, or names one session as a DM (not "all" — retired for the model). /tell <session> is a human DM; /tell all is the user's device-wide broadcast. Delivery is at the receiver's next step boundary, with the sender's current goal attached
- \\ • The model is told up front who else is live and what they're working on, so it coordinates — or picks disjoint work — before any collision
- \\ • /peek <session> shows what a live co-resident session is doing right now — its last prompt, last action, last tool
- \\ • Session recaps ride the event stream: settled turns carry a Completed or Needs-input status with a one-line recap for the GUI agent overview
- \\ • Subscriptions are billed and routed as subscriptions: a flat-rate login (Codex, Kimi, SuperGrok) now outranks an API key on the same provider instead of losing to it, costs $0 in /cost, and the key it displaced is parked and takes over — announced — only if the plan runs out of quota
- \\ • Worker tiers land on seats you already pay for: an explicit tier ask crosses to a logged-in plan (mid → k3, small → gpt-5.6-luna) rather than a metered rung — except a DeepSeek session (direct or via codegraff), which stays on flash instead of dropping to luna
- \\ • A tier rung must now be a genuinely cheaper SEAT, so anthropic descends opus-5 → sonnet-5 instead of to an equally-priced older opus, and deepseek-v4-flash replaces pro outright
- \\ • `graff route` with no model lists every provider you can reach, what it bills, and the tiers it offers
- \\ • Anthropic serves its live model list, so new Claude releases arrive without a rebuild
- \\
- \\0.0.243
- \\ • The terminal palette now matches codegraff.com: the identity accent is the site's emerald (#059669) — spinner, prompt, headings, tool-call lines, and attached-file chips — so a routine ⚙ bash line no longer reads as error red
- \\ • The ensō spinner actually turns now: six brush poses stepping at 100ms instead of four doubled poses every 320ms — the ~3fps stutter is gone
- \\
- \\0.0.242
- \\ • MCP tool schemas load on demand: a 13-tool server's catalog drops 64.8%, about 1,700 input tokens off every request; small servers stay eager and unchanged
- \\ • A big tool result returns a handle — preview, path, byte count, shape — instead of its contents, so it never occupies context turn after turn
- \\ • Sessions keep an append-only transcript compaction cannot rewrite, and compaction now states what survives on both sides of the boundary
- \\ • Windows: the transcript wrote 0 bytes on every run; the durable-transcript prompt line now waits for the first compaction instead of being paid for from turn one
- \\ • /btw asks a side question over the live context with tools off, then throws it away — billed, rendered, never added to the session
- \\
- \\0.0.241
- \\ • Goal/loop runs stop paying for verifications the workspace cannot have changed: an unchanged tree skips the eval command and its judge call, and the model is steered to edit first
- \\ • Oversized tool outputs spill to a session artifact the model can read or grep instead of being destroyed at the cap; throttles no longer masquerade as context overflows, and silent overflows recover in one trim
- \\ • The system prompt is capability-gated — embedder sessions drop ~15% of it — and a durable session's prompt names its own transcript
- \\ • Cross-process locks key on process START identity, a 426 WebSocket refusal latches SSE at once, and tool-execution output joined the typed event stream
- \\
- \\0.0.240
- \\ • Engine output now flows through a typed event stream behind a strict sink boundary — the start of the REPL/engine separation, with TUI and --json output proven byte-identical
- \\ • Quitting no longer strands the held Codex socket: loop exit closes the WebSocket and its response anchor, and debug builds finish with a clean allocator report
- \\
- \\0.0.239
- \\ • Codex WebSocket turns can't stall silently: visible output tightens the watchdog, a mute reused socket is retried in ~30s, and send/dial run under deadlines with Esc live
- \\ • A successful /login reaches the live session — codex auth recovery re-reads auth.json, spends the refresh token, and retries once instead of looping on a dead bearer
- \\ • Failed one-shots still print the [usage] footer and note completed tool work; rate-limit waits get a human duration; empty compaction summaries escalate instead of looping
- \\ • /save and /resume copy the typed name out of the readline buffer, and /rewind never deletes a file it failed to snapshot
- \\
- \\0.0.238
- \\ • Tight-budget runs hold back a landing reserve, so they finish, verify, and still deliver the final answer instead of dying mid-narration
- \\ • A completed run releases the terminal instead of suspending on tty input, and worker activity lines wait for the foreground's line boundary
- \\ • Completed todo items parked from a prior goal retire at the next ask instead of piling up across prompts
- \\ • Fleet workers retry transient failures within a bound — one flaky HTTP response can't lose a finished report, and budget refusals never blind-retry
- \\ • Search roles ride the small rung; landed turns feed local learning, and a learned decline names the policy it came from
- \\
- \\0.0.231
- \\ • edit_file verifies every edit actually landed on disk; a silent no-op is a loud tool error instead of a false success, and batched same-file edits can no longer race each other
- \\ • Embedder mode is complete: the hard --no-local-tools gate (MCP-sourced coding tools) plus resumable serve streams with seq ids, ?from=N replay, and durable sessions (schema 0.10)
+ \\0.0.302.4
+ \\ • streamed and dependent tool work retains call identity and result order
+ \\ • HTTP/2 requests use bounded, reusable transport where supported
+ \\ • ACP and desktop effort controls reflect the active model's capabilities
+ \\ • workspace recovery and usage reporting preserve uncertain outcomes
+ \\ • desktop navigation keeps real errors visible without covering a replacement page
+ \\
+ \\Full release history: https://github.com/justrach/codegraff/releases
\\
;