hn.today

Show HN: gavel: guided code review with your coding agent

photostructure.com4 points2 comments
Screenshot of Show HN: gavel: guided code review with your coding agent

Gavel is a free, MIT-licensed tool for reviewing local Git changes with Claude Code or Codex. Its premise is that reviewing AI-generated code should be a guided conversation, not a tiring slog through an alphabetized diff followed by manually copying file paths and line numbers into chat. The agent prepares a short explanation of why it made the change, describes important decisions and alternatives, and leads the reviewer through the code in a useful order. This lets the reviewer spend more attention judging the implementation and less on reconstructing its purpose and context.

Large changes can be divided into focused reviews, each with its own summary, proposed commit message, discussion threads, and approval or rejection verdict. Reviewers can ask for explanations, request revisions, leave notes beside specific lines, and follow the agent’s replies without leaving the diff; the agent can add requested changes and link back to them. Approvals authorize commits only after comments are addressed and required checks pass, while rejection stops the agent and prompts it to ask what to do next. Gavel also supports phone-based review through token-protected links, with HTTPS recommended for remote access. It requires Node.js 22.20 or newer and an installed agent skill. Feedback reaches the active coding session through Claude’s session socket or Codex queue, avoiding polling; if delivery fails, the reviewer can copy a resume prompt into the session. The developer built the tool after finding existing diff viewers inadequate for threaded, agent-guided reviews.

Read on photostructure.com2 comments on Hacker News

Summary generated by AI from the linked article. hn.today is not affiliated with Hacker News or Y Combinator.

More in Programming

Aristotle Expands into Rust

Aristotle has expanded its formal verification platform to Rust, allowing developers to prove code meets specifications and contains no undefined behavior, including in unsafe blocks. It can also verify that Rust rewrites behave like their original C code, targeting critical software such as smart contracts and infrastructure. (harmonic.fun)

The daily digest

Today's best Hacker News stories, summarized and screenshotted, one email a day.