The Problem
AI coding agents now write large shares of production code — and then review it themselves. The model that made the mistake is the model grading it, and it reliably gives itself good marks.
Most review helpers make it worse: they see a diff, not a codebase. Without structure — who calls this, what depends on it, when did it last change — review is guesswork with confidence formatting.
The Insight
Independent review needs an independent reviewer — and a real map of the codebase.
The Instrument
argus builds the map first: tree-sitter parses the repository, a PageRank-ranked repomap decides what matters, a code index and git history add context. Only then does an LLM reviewer — a different model from the one that wrote the code — read the change with that structure in hand.
It ships as one binary with eleven subcommands: map, diff, search, history, review, describe, feedback, hook, init, doctor, and mcp — an MCP server that plugs the whole instrument into the agent you already use.
Crate architecture
- mcp, agent interface
- review, LLM verdicts; connects to mcp
- repomap, PageRank map; connects to review
- difflens, change focus; connects to review
- gitpulse, history; connects to review
- codelens, semantic search; connects to review
- core, tree-sitter base; connects to repomap, difflens, gitpulse, codelens
Everything builds on core; review stands on four lenses; MCP exposes it all to agents.
Spec
- Interface
- One binary · 11 subcommands, including an MCP server
- LLM
- OpenAI · Anthropic · Gemini · Ollama
- Embeddings
- Voyage · Gemini · OpenAI — hosted only; semantic search has no local option
- Zero-cost path
- Gemini free tier — Google may use free-tier inputs to improve its products and human reviewers may read them, so use a paid key for private code
- Config
- .argus.toml + .argus/rules.md natural-language rules
- CI
- GitHub Actions workflow with --fail-on bug
- Install
- npm · crates.io · Homebrew tap (argus-ai 0.5.6)
- Adoption
- 2,516 npm + 418 crates.io downloads, Feb–Oct 2026 · 5 forks
- Quick start
git diff HEAD~1 | npx argus-ai review --repo .
The Outcome
On its own PR #24, argus posted three bug-severity findings before the merge. On 4 May 2026 an outside contributor’s fix restoring binary releases was merged (#75), and argus-ai 0.5.6 shipped to npm and crates.io with prebuilt binaries the same day.