Repository navigation
v6.0.0
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 waitwith 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_IDor$CODEX_THREAD_ID, unless--agentor--agent-session-idoverrides them;--agent-session-namesets 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: trueincomment snapshotand the review gets no tab, and an unnamed.,staged, orworkingreview 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: truewithapproved: falsethroughPOST /api/approval/not-yet(HTTP 404 on older servers) and clears it when the agent recaptures or changes the summary, or when astaged,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 schemaand 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 idleon 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 isgavel, and the repository is photostructure/gavel; the header and browser tab show the gavel mark. Nothing carries over from difit: there is nodifitcommand,DIFIT_EDITOR,DIFIT_EDITOR_COMMAND,DIFIT_EDITOR_ARGS, andDIFIT_CONFIG_DIRare nowGAVEL_EDITOR,GAVEL_EDITOR_COMMAND,GAVEL_EDITOR_ARGS, andGAVEL_CONFIG_DIR, the user config moves from~/.difit/config.jsonto~/.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 nowgavelandgavel-dev. - Bind approval of a
staged,working, or.review to the diff the reviewer saw:POST /api/approvalrequires thediffDigestfrom/api/diffand returns HTTP 409 when the diff has changed, and a later change to the diff revokes an as-is approval whencomment snapshotorGET /api/approvalreads it. The legacyPOST /api/ship-itroute now refuses these reviews with HTTP 409. - Keep the proposed commit message and rationale when a commit moves HEAD under a
stagedor.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 0and report it inserver.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
--jsonland a--no-jsonlhuman-output opt-out. - Include server readiness, comment progress, and thread changes in launch output; require explicit Delivered receipts.
- Remove the separate
comment watchcommand; retain snapshot recovery and companion commands. - Require
--no-jsonl --no-conversationtogether to disable conversations;--no-conversationalone now exits with an error. - Route startup and disconnect diagnostics to stderr in both output modes;
--no-jsonluses 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
vmarks a file viewed;von 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, andvused to toggle in place. With no keyboard cursor and the pointer outside every file, Shift+V now does nothing, likev; 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 throughPUT /api/auto-viewed-patterns;GET /api/user-settingsandPUT /api/user-settingsare 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.jsonis 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 row on a 375px-wide phone; it wraps when Refresh, an error, or the capture-update notice joins it.
- On phones and tablets in either orientation (any device whose main pointer is a touch screen), and in windows 500px tall or less, slide the header, review tabs, and Change summary out of view while the diff scrolls down, and bring them back on scroll up or when keyboard focus moves into them; file headers also use less padding. On an iPhone in landscape these rows and Safari's toolbars left about a third of the screen for diff lines.
- Turn off font ligatures in code text, so JetBrains Mono shows
=>,!==, and>=as the characters in the file. - While any review on the server asks for approval (it has a named capture or a proposed commit message, approved or not), the header shows the open review's name in place of the review picker, and the review tabs switch reviews; this covers every
--reviewlaunch and every launch with--commit-message. Picking another comparison created reviews the tabs had no place for. A Detailed... dialog that was already open closes. Otherwise, when gavel is launched for an explicit commit-ish (gavel HEAD~1,gavel .), the review picker offers only that diff and Recent reviews: Quick Diffs, Previous commit, Pick Commit..., Detailed..., and commit and branch search are gone, so a review opened for approval can't switch to a diff nobody proposed. Launched diff returns to the launch's resolved commits. A baregavelkeeps the full picker.GET /api/revisionsreports the launch aslaunch. - Diff Preview now shows a Markdown frontmatter block that is not a YAML key/value mapping (a syntax error, a scalar, a sequence, or an empty or comment-only block) when the diff starts at the top of the file, even when it did not change. The lines render as Markdown:
---delimiters appear as horizontal rules, a YAML line directly above the closing---becomes a heading, and comment lines become headings. It used to hide the block. - In Conversation, Escape in a reply or an edit that holds text closes the panel and keeps any unsent text, as it does for a line draft listed under Unsent drafts. Escape used to leave a reply and the panel open, and discard an edit's changes.
- Escape no longer discards unsent text anywhere; only Cancel or Send does. In the diff, Escape in a line comment or an edit with unsaved changes keeps the form open, as it already did for a reply, and Escape in an edit you have not changed closes it; Escape used to discard a line comment's or an edit's text. In Conversation, Escape in the general comment form closes the panel and keeps its text for the next open; it used to discard it.
Removed in the PhotoStructure fork
- Remove the bundled VS Code extension (
packages/vscode). It was set up to publish under upstream's Marketplace publisher, which this project cannot publish under. - Remove the project site and its static live demo (
src/site,pnpm dev:site,pnpm build:site,pnpm export:site-data, and the Pages workflow). The demo could not show an agent answering comments; the walkthrough on photostructure.com replaces the site.
Fixed in the PhotoStructure fork
- Keep unsent text in a line comment, a reply, or an edit through a reload, a page crash, a development-server hot update, or a switch to another review tab: each draft is saved in the tab's sessionStorage per review and its form reopens with the text, expanding the context around its line and opening its file even if the file is marked viewed. A draft whose line the diff no longer shows appears at the top of its file. Conversation lists every unsent draft under Unsent drafts, including drafts on files no longer in the diff, with a pencil badge on the button that counts them; the list is taken when the panel opens. Opening a second line comment in the same hunk no longer closes the first one and discards its text.
- Show an edit inside Markdown frontmatter that is not a YAML key/value mapping in Diff Preview: a YAML syntax error, a scalar such as
title New, a sequence, or a blank or comment-only block. The preview used to strip the frontmatter lines anyway, so the edit appeared in neither the frontmatter table nor the preview; it now keeps the lines and shows no table. - Size the app shell, the loading and error screens, and the Settings dialog with
dvhinstead of100vh. iOS and iPadOS Safari resolve100vhto the height with the toolbar collapsed, so while the toolbar showed, the last lines of the diff sat under it until another swipe scrolled the page. The page no longer scrolls, so Safari's toolbar stays visible.
Full Changelog: v5.1.0...v6.0.0