Skip to content

Releases

v8.0.0

Choose a tag to compare

@github-actions github-actions released this 22 Nov 03:14
Immutable release. Only release title and notes can be modified.
v8.0.0
9c7ff14

Breaking changes

  • Without --host, or with --host localhost, gavel listens on and links to 127.0.0.1, and companion commands default to --host 127.0.0.1. Pass --host ::1 for an IPv6 loopback bind. Viewed marks and drafts saved under the old localhost address stay there.
  • Agent review creation and inbox reattachment go through a local socket. An HTTP request that supplies an inbox destination is refused; run the gavel CLI on the repository's machine instead.
  • In a named review, --comment and gavel comment add refuse a thread outside every hunk of its file and add none of the comments; the error lists that file's hunk ranges.
  • Working-tree file and image reads no longer serve files under .git/, files Git ignores, or files inside a submodule's checkout, so Markdown images pointing at such files stop loading.
  • Threads a browser kept from a gavel build before 7.0.0 and never sent are no longer sent when the review reopens. Open such reviews with 7.0.0 first.
  • A named review no longer previews a captured binary file that is larger than 64 MiB once reconstructed; its blob request fails. Keep such files out of named reviews.

New features

  • Comments show their author (agent, you, or a deleted GitHub account) as an icon beside the text, and your unanswered comments show their progress, reaching Delivered as soon as a Claude Code chat receives them.
  • Each thread ends in a one-line reply box that grows as you type, and the Comment / Change request / Question choice is gone.
  • About, the robot menu, and copied comment prompts name the agent session that launched the review, read from its Claude Code title or Codex thread name, and follow renames. About shows an orange "failed to parse" with the cause when that lookup fails.
  • The robot menu's session name and ID, and every row under "This review" and "Server" in About, have copy buttons.
  • gavel review withdraw <name> --reason <text> pulls back a named review: its tab stays, struck through with a red X, the reason shows at the top of the review, and it takes no new verdict.
  • Press a to open About.
  • When your network comes back after an outage, gavel reconnects and sends your unsent comments without a click on the red robot.
  • Review tabs and All reviews menu items with a verdict get a light tint in that verdict's color, so the reviews still needing one stand out.
  • The commit message in Change summary starts 80 characters wide, and dragging the edge beside Why this change resizes it; the browser remembers the width.
  • Agent comments and replies that omit author name the agent host that launched gavel, such as "Codex desktop", instead of "Agent".
  • Claude Code and Codex agents aim for reviews of 300–500 weighted changed lines and follow a review size you set in CLAUDE.md or AGENTS.md.
  • The gavel skill has agents write --why as a summary of at most 200 words with Problem, Change, and Alternatives paragraphs, plus Tests and Review lines.

Bug fixes and polish

  • The access token leaves the address bar and comment-link addresses once the page opens, so a copied page address no longer grants access.
  • A link carrying gavel-token, in review content or on another website, no longer logs the tab out. After a token rotation, each repository's gavel page shows the access screen once, even from a new launch link; open the link again.
  • A directly opened repository SVG or other blob can no longer run scripts on the review page's origin; SVG previews still work, but external resources inside them are blocked.
  • Unicode bidi control characters in diff code, file names, and comments show as markers such as <U+202E> instead of reordering the line.
  • gavel review unapply and gavel review reapply no longer delete .rej files outside the worktree.
  • Untracked files and watched files whose names start with - are passed to Git as paths, so a file named --stdin no longer stalls live reload.
  • A long path with many spaces followed by a/ or b/ no longer stalls the server while its diff is parsed. Markdown previews show oversized or cyclic YAML frontmatter as source.
  • During an unresolved merge, reviews list every conflicted file, including modify/delete conflicts, and Git stops printing fatal: errors to gavel's terminal for them.
  • A file you marked viewed stays viewed after a rebase that moves its hunks without changing them; files viewed before this release may show as changed once.
  • Long diffs, such as a large deleted file, scroll smoothly in Safari on an iPad.
  • Moving the pointer over a long diff responds faster.
  • A server starting up deletes saved reviews untouched for 90 days, instead of 7, so a review reopened weeks later keeps its comments, progress and approval.
  • The page keeps its scroll position when the agent runs gavel review update on the open review.
  • Files in a directory that appears after the diff reloads show in the file tree instead of under a collapsed folder.
  • While the server is unreachable, the verdict buttons show the verdict you last chose, so clicking a pressed verdict clears it once.
  • Range links open hidden context around their last line instead of unfolding every hidden gap they span.
  • In split view, h / l move to the line shown beside the cursor, Shift+N / Shift+P land where a range comment's card shows, and { / } land on the column with content.
  • Pressing ? again closes the keyboard shortcuts help.
  • Protocol-relative links (//host/x) render as plain text, and upper-case HTTPS:// links and off-origin Mermaid click links open in a new tab without a referrer.
  • When the browser refuses a copy, the file-path, About, Copy reply, Copy prompt, and Copy All Prompt buttons show a red alert icon and a "Copy failed" toast instead of doing nothing.
  • --pr comment imports treat repository names and pagination cursors as literal strings.
  • Git operations honor GIT_CONFIG_GLOBAL, GIT_CONFIG_SYSTEM, and GIT_CONFIG_NOSYSTEM.
  • The file tree is denser and sits further left, with smaller names and indents, top-level icons under the filter box's search icon, and a checkbox that replaces a file's icon on hover. Hovering a folder shows its path.
  • Review tabs show names in the interface font, and Why this change text matches the commit message's visual size.
  • The agent protocol docs are gone; run gavel --help, gavel <command> --help, or gavel schema, and gavel pending --help shows the Claude Code hooks that run it.
  • Remote review replaces docs/server-addresses.md and explains what the access token protects, and the README gives gavel's measured token cost.
  • The Claude Code skill is about a quarter shorter, forbids every form of waiting for review activity, and always shares the full review link with its access token.
  • Agents hold a review back only after you have been idle for an hour, not 10 minutes. After a Reject, they unapply only their own capture and ask separately before removing the worktree, the local branch, or a pushed branch.

Full Changelog: v7.0.0...v8.0.0

v7.0.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 05:24
Immutable release. Only release title and notes can be modified.
v7.0.0
d2f51a7

Breaking changes

  • The verdicts are Approve and Reject, replacing Approve as-is, Approve after comments, and Not yet. Approve tells the agent to address your comments and commit, and it survives recaptures; only you can clear a Reject (see approval modes).
  • The approval JSON in /api/approval, comment snapshot, review.approval events, and gavel approval status carries one verdict field (approve or reject) in place of approved, requested, mode, notYet, conditionalSupported, conditions, baselineCapture, and diffDigest. review.approval events and gavel approval status also lose their top-level approved, and gavel approval status loses name (read selection.reviewName).
  • PUT /api/approval sets a verdict and DELETE /api/approval clears it; POST /api/approval, /api/approval/conditional, /api/approval/not-yet, gavel comment address, and gavel schema address are gone.
  • Change summary is read-only and sits at the top of the diff; ask the agent in a comment for a different message. POST /api/review-summary is gone.
  • Each browser tab uses one WebSocket, /api/live, replacing /api/watch, /api/heartbeat, and POST /api/presence, so more than two tabs per server load. Proxies must pass WebSocket upgrades on /api/live.
  • Copy Prompt, Copy All Prompt, /api/comments-output, and the comments printed at shutdown use XML-style tags instead of label lines and ===== separators. Copied prompts also name their repository and agent session.
  • review create and review update fail when stdin is a pipe, socket, or file and none of -, --capture, --pathspec, or --include-untracked is given; to capture the working tree from such a script, redirect stdin from /dev/null.
  • POST /api/comments accepts only JSON bodies, merges when baseVersion is omitted instead of replacing every thread, and returns HTTP 400 for an invalid baseVersion or a body with neither threads nor comments.
  • The page and every /api request require the access token from the launch link (#gavel-token=…), which the browser remembers per address. Scripts must send X-Gavel-Token with the contents of ~/.gavel/access-token; X-Gavel-Editor-Token and #gavel-editor-token are gone. See access token.
  • Without --port, a server picks a port in 10081–32767 from its agent session and repository instead of 4966, so a restarted review usually keeps its address. Pass --port 4966 for the old one.

New features

  • gavel review rename and gavel review delete rename or remove a named review on a running server; a deleted review's comments stay in Conversation until the server stops.
  • gavel review unapply <name> reverts a named review's patch, for example after a Reject, and reports hunks it could not revert; gavel review reapply <name> applies it again.
  • Verdicts and comments go to the Claude Code session that opened the review, even when it is idle, or are queued for the Codex chat that opened it.
  • The header's robot icon turns red when verdicts and comments won't reach the agent, and orange when another review's server holds the address; its menu says what to do, and a click reconnects to an unreachable server.
  • Copy resume prompt in the robot's menu names the review's agent session, host, and repository, and a chat that is not that session asks you to confirm before it continues.
  • The access screen's Copy prompt for your agent button asks your agent for the page's full link with its access token.
  • gavel pending prints review activity that never reached a Claude Code session, for example after the session restarted. Run it from UserPromptSubmit and SessionStart hooks; see waiting for review.
  • gavel comment snapshot --review <name> prints only that review and exits 1 if there is none; it also accepts a reviewId or inbox label. gavel comment delete --review <name> deletes threads from a named review.
  • pkill -USR2 -x gavel-server stops every server whose review tabs all have a verdict, and every --no-lgtm server with a review tab; others keep running. Background servers now release review locks on SIGTERM.
  • Links in comments jump to a comment (#thread=<id>), to lines of a file (#file=<path>&line=40-52), or into another named review (?review=<name>#…), and Back returns to the link. See links in comments.
  • Why this change in Change summary shows its text as Markdown, so links in it work.
  • Conversation lists and counts agent replies from every review on the server. Read marks are now saved per repository, so replies you already read show as unread once.
  • A new agent reply pulses Conversation's unread count and shows in the tab title, and review tabs and Files changed mark unread replies with a blue dot.
  • Shift+A approves and Shift+X rejects the open review, and f shows or hides the Files changed panel.
  • Dragging on line numbers selects a range and opens a comment form for it.
  • Unsent comment drafts survive closing the tab and are shared between tabs on the same review. A draft untouched for 7 days is deleted.
  • Comments and verdicts made while the server is unreachable wait in the browser and are sent when it answers; a toast says so and offers Send again now.
  • Named reviews expand the lines between and around hunks, and Expand all lines shows the whole file, unless gavel cannot rebuild that file from the capture.
  • Named reviews show binary image and WebM video diffs, and the image viewer plays WebM videos in live diffs too.
  • Shift+Click or Alt+Click on a gap's arrow expands the whole gap, and clicking the bar beside the arrows does what the arrow does.
  • A button beside each file's name opens the file in your editor. Shift+Click or Alt+Click on the copy button copies the file's absolute path.
  • About shows the running version, links to the changelog under What's new, and says whether npm has a newer release; NO_UPDATE_NOTIFIER=1, DO_NOT_TRACK=1, or Global Privacy Control skips that check.
  • About links to How gavel works and, on a development build, shows the commit and uncommitted-changes hash it came from, as node dev/build-info.js does for the checkout.
  • After a verdict, a toast offers Undo and the next review; Return takes the next step and Escape dismisses it. gavel no longer switches reviews or closes the tab on its own.
  • The review tabs stay full size on one row that scrolls sideways, and an All reviews button at its end lists every review, with a bar counting each verdict.
  • The review header fits itself to its width: it drops button labels, then the review name, then the logo, before it folds Approve and Reject into a menu.
  • Clicking a comment moves the line cursor to its line, and the file list highlights the cursor's file, or Change summary while it is at the top of the diff.
  • Files with more than 1,024 changed lines start collapsed with a Load diff button, so very large diffs open quickly.
  • Back returns to the review you were reading before you switched reviews.
  • The gavel skills have agents title every launch, link guide comments into a tour, undo a rejected change with gavel review unapply, and stop the server once every verdict is carried out. Claude Code agents no longer run gavel wait.

Bug fixes and polish

  • Comments on the old side of an unchanged line show in the unified diff, not only in split view.
  • In the unified view, dragging a comment selection across a row with no line number on the selection's side no longer takes the other side's number.
  • Diff Preview shows the frontmatter lines when the table cannot show an edit, such as a comment, quoting, or key-order change.
  • Diffs read the same under any diff.noPrefix, diff.srcPrefix, diff.dstPrefix, diff.submodule, or core.quotePath setting. Copies are labeled as copies, and a type change, such as a file replaced by a symlink, is one modified file.
  • Files with non-UTF-8 names appear under Git's quoted form instead of collapsing into one path, a path containing /dev/null stays modified, and a file with content conflicts is listed without its conflict hunks.
  • The Viewed button follows gavel's theme setting instead of the operating system's.
  • The file tree starts closed on phones, and closing the phone drawer no longer hides the tree the next time a wide window loads.
  • Dockerfiles, Makefiles, TOML, INI, Lua, R, nginx configs, .gitignore, C/C++ headers and .cc/.cxx sources, and .markdown files are syntax highlighted.
  • An image or video whose size request fails no longer shows the error page's size as its file size.
  • The copy-file-path and Copy All Prompt buttons keep their copied state for 2 s after the latest click.
  • Disabled buttons no longer show a pointer cursor, and the Write a reply... box shows a text cursor.
  • Screen readers announce the Font Size, Font Family, and Syntax Highlighting Theme settings by name, and clicking a label focuses its control.
  • A working-tree review no longer takes a commit's message as its proposed commit message when both diffs load at once.
  • Opening another review ends the approval animation.
  • Closing a page whose server has stopped no longer asks you to confirm leaving.
  • The keyboard help says Shift+R refreshes the diff at any time.
  • Split/Unified and Ignore Whitespace moved from the header's View menu to the top of Settings → Appearance, and Ignore Whitespace is now remembered. Font size goes down to 9 px.
  • Reject is violet (orange in deuteranopia mode), and the verdict menu marks Approve with a green check.
  • Settings dims the page, closes on Escape or an outside click, keeps focus inside, and is announced as a dialog. Keyboard Shortcuts also take...
Read more

v6.0.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 07:40
Immutable release. Only release title and notes can be modified.
v6.0.0
d0a944d

Added in the PhotoStructure fork

  • Save each review's comments, progress, proposal and approval under .git/gavel, and restore them when a restarted server opens the same named review and patch, or the same commits. gavel approval status <commit> reports a commit's saved approvals without a server. A server starting up deletes saved reviews untouched for 7 days.

  • Find unread agent replies in Conversation with visible filter pills, per-reply read/unread controls, Mark all read, and jumps into resolved or outdated threads. Visibility and panel close never mark replies read.

  • Answer an agent reply with one click: 👍 Agreed, ❓ Still unclear, and 👎 Disagree post ordinary replies beside Write a reply....

  • Report browser visibility and agent-listener presence; offer a resume prompt for agents that cannot receive idle notifications.

  • Stop gavel wait with exit 4 when every selected review is unattended, after recovering existing human work.

  • Show the launching agent and its session's name and ID under About. The agent comes from $CLAUDE_CODE_ENTRYPOINT, the Codex thread's rollout, or $AI_AGENT, and the ID from $CLAUDE_CODE_SESSION_ID or $CODEX_THREAD_ID, unless --agent or --agent-session-id overrides them; --agent-session-name sets the name.

  • Add comments to a named review on a reused server with gavel comment add --review <name>.

  • Show a row of review tabs under the header when a review on the server carries a named capture or a proposed commit message, unless it is the only such review and it is open. A commit message the server copied from a browsed commit is not a proposal: the review's summary carries fromCommit: true in comment snapshot and the review gets no tab, and an unnamed ., staged, or working review left behind when a commit moves HEAD gets no tab either. Each tab names one review, in creation order, with a ✓ (approved), ✕ (Not yet), or ○ (no verdict) mark in its verdict button's color, which also colors the open tab's top border; the row counts how many still need a verdict. Picking a tab replaces the browser's history entry, so Back does not step between reviews. When the tabs don't fit on one row, they collapse into a menu on the open review's tab. The Change summary panel now stays open or closed across reviews and reloads, so stepping through a stack doesn't collapse it each time. Reviews used to be reachable only from Recent reviews in the review picker's menu, where reviewers missed them. The gavel skills now tell agents to open stacked commits as one named review per commit, in commit order, and give the user one link.

  • Decline a review with Not yet, beside the approval buttons; it turns red on hover and once chosen. The server records approval.notYet: true with approved: false through POST /api/approval/not-yet (HTTP 404 on older servers) and clears it when the agent recaptures or changes the summary, or when a staged, working, or . diff changes. Closing the window used to be the only way to decline.

  • After a verdict, show a notice under the verdict buttons that counts down 10 seconds, then opens the next review without one, or closes the tab once every review has one, with Switch now or Close now to skip the wait and Cancel to stop it; when the browser keeps the tab open, say it can be closed. A review that arrives during the countdown takes it over. While a review lacks a verdict, its tab pulses after a verdict elsewhere, and leaving the page brings up the browser's leave-site dialog.

  • Discover launch events and agent JSON requests/responses through gavel schema and command help.

  • Wait silently for human activity across review servers with gavel wait; recover queued messages without implicit delivery receipts.

  • Print the desktop user's idle time with gavel idle on Linux (KDE on X11, GNOME), macOS, and Windows, so agents can hold a review until the user is back.

  • Restore the conversation event endpoint with cursor replay of the latest 256 events per server process.

Changed in the PhotoStructure fork

  • Rename the project from difit to gavel, because speech-to-text could not transcribe "difit" in dictated prompts. The npm package is @photostructure/gavel, the command is gavel, and the repository is photostructure/gavel; the header and browser tab show the gavel mark. Nothing carries over from difit: there is no difit command, DIFIT_EDITOR, DIFIT_EDITOR_COMMAND, DIFIT_EDITOR_ARGS, and DIFIT_CONFIG_DIR are now GAVEL_EDITOR, GAVEL_EDITOR_COMMAND, GAVEL_EDITOR_ARGS, and GAVEL_CONFIG_DIR, the user config moves from ~/.difit/config.json to ~/.gavel/config.json, saved reviews start fresh under .git/gavel, and browser settings, viewed marks, unread marks, unsent drafts, and the Change summary panel's open state start fresh. Set auto-viewed patterns again in Settings. The skills are now gavel and gavel-dev.
  • Bind approval of a staged, working, or . review to the diff the reviewer saw: POST /api/approval requires the diffDigest from /api/diff and returns HTTP 409 when the diff has changed, and a later change to the diff revokes an as-is approval when comment snapshot or GET /api/approval reads it. The legacy POST /api/ship-it route now refuses these reviews with HTTP 409.
  • Keep the proposed commit message and rationale when a commit moves HEAD under a staged or . review, unless that commit has the proposed message. The new review used to start with an empty summary.
  • Bundle JetBrains Mono, IBM Plex Mono, and Ubuntu Mono for Settings → Font Family, so each choice renders the same whether or not the font is installed, and add Browser default for the monospace font set in the browser. JetBrains Mono replaces System Font as the default. System Font, Menlo, SF Mono, and Fira Code are removed; a saved choice of one of them falls back to JetBrains Mono.
  • Bind an OS-assigned port with --port 0 and report it in server.ready; reject non-numeric ports instead of falling back to 4966.
  • Open thread reply forms from Write a reply... again. Escape or a click elsewhere closes an empty form; a draft stays open until Cancel discards it. Every comment form has Cancel at the opposite end of the row from Send (Save when editing a comment), and after it in tab order.
  • Emit JSON Lines from the foreground launch process by default, with --jsonl and a --no-jsonl human-output opt-out.
  • Include server readiness, comment progress, and thread changes in launch output; require explicit Delivered receipts.
  • Remove the separate comment watch command; retain snapshot recovery and companion commands.
  • Require --no-jsonl --no-conversation together to disable conversations; --no-conversation alone now exits with an error.
  • Route startup and disconnect diagnostics to stderr in both output modes; --no-jsonl uses human-readable comment and approval output on stdout.
  • Rename the header's Repository button to About.
  • Play approval celebrations at double speed and stop any still running at 3 seconds; they used to run 3.4 to 6.5 seconds.
  • Drop the files-viewed count (such as "0/8") from the header; the file tree still shows it. The header used to show it while the file tree was closed.
  • Move to the next unviewed file when v marks a file viewed; v on a viewed file un-marks it and stays put. Shift+V now toggles viewed without moving. Shift+V used to mark viewed and move on, and v used to toggle in place. With no keyboard cursor and the pointer outside every file, Shift+V now does nothing, like v; it used to act on the last cursor position.
  • Replace the approval split button with Approve as-is, Approve after comments, and Not yet buttons from 1280px wide. Approve after comments used to sit behind the split button's arrow. Clicking the chosen button again clears the verdict, as Clear verdict does in the narrow-screen menu; Revoke approval is gone. Clicking Approved as-is used to send the same approval again.
  • Stop two ✨ emoji from rising beside the files-viewed status when the last file is marked Viewed; All files viewed and the full progress bar still mark completion.
  • Highlight the file at the top of the diff in Files changed as the diff scrolls. The highlight used to mark the keyboard cursor's file, and stayed on it after the diff scrolled away.
  • Open Settings from its own gear button instead of from View, and drop View's light/dark switch, which duplicated Settings → Theme. Below 1024px wide, View, Settings, About, and Conversation show only their icons, so the header fits one row on an iPad in portrait.
  • Keep UI settings (appearance, Split/Unified, file tree width and visibility) in a cookie in each browser instead of ~/.gavel/config.json, so an iPad and a desktop keep separate font sizes and themes. Cookies ignore the port, so settings still survive gavel starting on a new port. Auto-viewed patterns stay in ~/.gavel/config.json, shared by every browser, and save through PUT /api/auto-viewed-patterns; GET /api/user-settings and PUT /api/user-settings are removed. A browser that refuses the cookie shows an error in the header instead of losing settings changes silently.
  • Stop loading the diff when ~/.gavel/config.json is not valid JSON or does not hold an object, and name the file on the page; such a file used to be ignored. Diff load errors now show the server's message instead of "Failed to fetch diff data" when it sends one.
  • Below 1024px wide, show only icons on the review picker; its menu names the comparison. Below 1280px wide, the verdict buttons become one menu that shows the current verdict. Below 768px, drop the logo from the header and move the unread-reply count onto the corner of Conversation, so the header fits one ...
Read more