persiyanov/herdr-reviewr

herdr‑reviewr – a terminal‑based code‑review pane for herdr

What it is

• A plugin for the herdr AI‑assistant terminal UI that shows a live diff of the files an agent has just written. You can scroll through the changes, add line‑or‑range comments, and send those comments back to the agent without leaving the terminal.
• Works as a split pane next to the chat window, or as a standalone terminal program.

Key capabilities

• Four diff scopes – view uncommitted changes, the whole branch, the last “turn” of the agent, or an arbitrary set of commits.
• Line‑level commenting – select lines (v), type a comment (c), edit/delete (e/d), then send all comments to the agent (s).
• Navigator – fuzzy file search, live grep (via the fff tool), and a file‑viewer that can also render Markdown.
• PR tab – read‑only view of the current pull/merge request from GitHub, GitLab or Azure DevOps (requires the respective CLI tools).
• Themes & UI – 18 built‑in dark/light palettes, configurable via --theme or a TOML config file.
• Customizable keybindings – every action can be rebound; defaults are listed in the README.

How to get it

1. With herdr installed (≥ 0.7.5):

   herdr plugin install persiyanov/herdr-reviewr
   herdr plugin action invoke open --plugin persiyanov.reviewr
   

2. Standalone (no herdr): download a pre‑built binary from the releases page and run it against a repository:

   herdr-reviewr ~/my/project
   

   (Only the UI works; the Send and last‑turn scopes need herdr.)

Configuration

• CLI flags: --poll <ms>, --base <ref>, --theme <name>, --wrap on|off.
• Persistent TOML file at ~/.config/herdr/plugins/config/persiyanov.reviewr/config.toml for defaults such as theme, default_scope, navigator position, editor command, and custom keybindings.
• The plugin respects .gitignore; large files (> 2 MiB or 50 k lines) are omitted from diffs.

Limitations

• Requires a true‑color terminal and Unicode box‑drawing characters; no fallback for 256‑color terminals.
• macOS or Linux only – no Windows support.
• Clipboard integration depends on pbcopy, wl-copy, xclip or xsel.
• Comments exist only in memory for the current session; closing the pane discards unsent comments.
• “Send” works only when an agent is present in the herdr workspace.
• PR view is read‑only and limited to the first 100 comment rows per thread.

Roadmap highlights

• Structured JSON export of comments.
• Side‑by‑side split view.
• Automatic light/dark theme detection via OSC.
• Additional themes (e.g., kanagawa, everforest) and OSC‑52 clipboard support.

License

• MIT license for the code.
• Syntax‑highlighting assets come from syntect and two-face under their respective licenses.

---

herdr‑reviewr is a practical tool for developers who use AI coding agents inside the herdr terminal UI and want a focused, keyboard‑driven way to review and comment on generated code without leaving the console.