Repository navigation
v7.0.0
·
101 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
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.approvalevents, andgavel approval statuscarries oneverdictfield (approveorreject) in place ofapproved,requested,mode,notYet,conditionalSupported,conditions,baselineCapture, anddiffDigest.review.approvalevents andgavel approval statusalso lose their top-levelapproved, andgavel approval statuslosesname(readselection.reviewName). PUT /api/approvalsets a verdict andDELETE /api/approvalclears it;POST /api/approval,/api/approval/conditional,/api/approval/not-yet,gavel comment address, andgavel schema addressare 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-summaryis gone. - Each browser tab uses one WebSocket,
/api/live, replacing/api/watch,/api/heartbeat, andPOST /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 createandreview updatefail when stdin is a pipe, socket, or file and none of-,--capture,--pathspec, or--include-untrackedis given; to capture the working tree from such a script, redirect stdin from/dev/null.POST /api/commentsaccepts only JSON bodies, merges whenbaseVersionis omitted instead of replacing every thread, and returns HTTP 400 for an invalidbaseVersionor a body with neitherthreadsnorcomments.- The page and every
/apirequest require the access token from the launch link (#gavel-token=…), which the browser remembers per address. Scripts must sendX-Gavel-Tokenwith the contents of~/.gavel/access-token;X-Gavel-Editor-Tokenand#gavel-editor-tokenare 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 4966for the old one.
New features
gavel review renameandgavel review deleterename 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 pendingprints review activity that never reached a Claude Code session, for example after the session restarted. Run it fromUserPromptSubmitandSessionStarthooks; see waiting for review.gavel comment snapshot --review <name>prints only that review and exits 1 if there is none; it also accepts areviewIdor inbox label.gavel comment delete --review <name>deletes threads from a named review.pkill -USR2 -x gavel-serverstops every server whose review tabs all have a verdict, and every--no-lgtmserver 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
fshows 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.jsdoes 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 rungavel 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, orcore.quotePathsetting. 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/nullstays 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/.cxxsources, and.markdownfiles 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 takes focus when it opens.
- Keyboard shortcuts and Star on GitHub moved from the bottom of the file list to the top of About, which groups its details under This review, Server, and Build.
- Clicking anywhere on a file or comment-thread header row expands or collapses it, and the file header's buttons take clicks that land just outside them.
- Comment text uses the card's full width and the interface's sans-serif font. Resolve and a ⋯ menu sit in the thread heading, and each reply has its own ⋯ menu.
- The Agreed, Still unclear, and Disagree buttons are gone. Type a reply, or resolve the thread, which marks its agent replies read.
- The read dot in a thread's heading acts on every agent message in the thread, and the jump-to-unread dot shows only on collapsed threads.
- The cursor keys stop at the review's first and last line instead of wrapping, enter expanded Viewed files and, in split view, new or deleted files, and skip collapsed files.
- The comment a link or Conversation click leads to gets a blue ring that throbs once, and its file opens even when marked Viewed.
- Toasts share the comment cards' look and sit under the verdict buttons, above Conversation. The "Link not followed" notice moved there from the bottom of the window and closes after 8 seconds.
- The About and Conversation panels and the phone file tree slide in and out over 0.3 s, and toasts slide in; with reduced motion they appear at once.
- The expand arrows between hunks follow GitHub's convention: up reveals lines above the hunk below it, and down reveals lines below the hunk above it.
- Green text and icons in the dark theme are brighter, and the Change summary labels and Conversation headings match the size of other panel headings.
- The documentation, CLI help, and server output say "approve" and "verdict" instead of "LGTM"; the CLI aliases still work.
- The README is shorter, its screenshots show the current UI, and its logo stays visible on npm's dark theme.
Full Changelog: v6.0.0...v7.0.0