Skip to content

The CollectionInstrument No. 01

argus

Your coding agent shouldn’t grade its own homework.

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.