demo.mp4
agent-review enables a streamlined workflow: use one AI agent (Claude, Cursor, Gemini) to implement features, then instantly get a second opinion from a different agent. The package automatically collects your git changes and sends them to your chosen AI agent for review. The cross-agent review catches issues that single-agent workflows miss, while the tight feedback loop means you fix problems quicker and more efficiently.
All findings display in a navigable list interface where you can jump to issues, triage by severity, and send fixes back to your implementation agent—closing the loop without leaving Emacs.
- Emacs 29.1 or later
- acp.el >= 0.7.1
- agent-shell >= 0.16.2
- Git
- An ACP-compatible agent (Claude Code, Cursor, Gemini CLI, etc.)
This package builds on the excellent work by xenodium on acp.el and agent-shell. Consider supporting their work!
For setting up individual agents (Claude Code, Cursor, Gemini CLI, etc.), follow the agent-shell setup guide.
(straight-use-package
'(agent-review :type git :host github :repo "nineluj/agent-review"))Add to your packages.el:
(package! agent-review
:recipe (:host github
:repo "nineluj/agent-review"
:files ("*.el")))Clone this repository and add to your load path:
(add-to-list 'load-path "/path/to/agent-review")
(require 'agent-review)- Make some changes in a git repository
- Run
M-x agent-review - Select an agent from the list
- Wait for the review to complete
- Browse issues in the
*Agent Review*buffer
| Key | Action |
|---|---|
| RET | Jump to issue location |
| g | Refresh (re-run review) |
| q | Quit review buffer |
| n | Next line |
| p | Previous line |
| m | Mark issue at point |
| u | Unmark issue at point |
| M | Mark all issues |
| U | Unmark all issues |
| W | Copy marked issues to kill ring |
| S | Send marked issues to agent-shell |
;; Use a specific agent configuration
(agent-review (agent-shell-anthropic-make-claude-code-config))Set a preferred agent to skip the selection prompt:
(setq agent-shell-preferred-agent-config
(agent-shell-anthropic-make-claude-code-config))If git is not in your PATH:
(setopt agent-review-git-executable "/path/to/git")- Collection: Runs
git diffandgit diff --cachedto get changes - Analysis: Sends changes to AI agent with structured prompt
- Parsing: Extracts issues in format
FILE:LINE|SEVERITY|DESCRIPTION - Display: Shows results in tabulated-list-mode with color-coding
Severity File Line Description
────────────────────────────────────────────────────────────────
error src/main.el 42 Variable 'unused-var' is defined but never used
* warning lib/utils.el 15 Function docstring is missing
suggestion tests/test.el 8 Consider adding edge case test
(Issues can be marked with m for batch operations)
Run agent-review from within a git repository.
Make some changes first (either stage them or leave them unstaged).
Install git or configure agent-review-git-executable.
The agent may not have found any issues, or the response parsing failed. Check the agent's actual response format.
Issues and pull requests welcome at https://github.com/nineluj/agent-review
GPL-3.0-or-later