argus-claude

Argus

The all-seeing code reviewer

Argus is a multi-agent code review system designed to detect and prevent architecture drift in evolving codebases.

It runs specialized agents in parallel—covering areas like architecture, naming, dependency injection, dead code, and error handling—and validates every finding against the code. Argus also integrates with the Codex CLI and Gemini to cross-validate results across multiple LLMs, discarding any unverified issues and surfacing only accurate, actionable feedback.

Quick Start

# Add marketplace
/plugin marketplace add josstei/argus-claude

# Install
/plugin install argus@josstei-argus-claude

# Run a review
/argus:review              # Shows confirmation prompt
/argus:review --yes        # Accepts defaults immediately

Select a review level and go. No configuration needed.

Review Levels

Level	Model	Time	Token Usage	Best For
Fast	Haiku	~2 min	Low	Quick checks during development
Balanced	Sonnet	~5 min	Moderate	Regular code reviews
Comprehensive	Opus	~8 min	Higher	PR reviews, releases

/argus:review                     # Shows confirmation prompt
/argus:review --level fast        # Skip prompt, use Fast
/argus:review --level balanced    # Skip prompt, use Balanced
/argus:review --yes               # Skip prompt, use defaults

Commands

Command	Description
/argus:review	Run code review
/argus:config	View settings
/argus:help	Show help

Settings

/argus:config set scope src/       # Always review src/
/argus:config set output markdown  # Always save reports

Config File

Argus reads only the user-level config file:

• User: ~/.claude/argus.json (personal, all projects)

Review Phases

Phase	Focus
Architecture	Boundary violations, layer issues
Code Hygiene	Dead code, unused exports
Naming	Convention compliance
Quality	DI patterns, error handling, resources
Optimization	Performance opportunities

Phases run based on depth setting:

• quick - Architecture + Hygiene
• standard - All except Optimization
• thorough - All phases

External Validators

Enable cross-validation with other LLM CLIs:

/argus:review --external

Requires Codex CLI and/or Gemini CLI installed. Argus auto-detects availability and only enables detected tools.

Philosophy

Argus prioritizes long-term excellence over quick fixes:

• Recommends the RIGHT solution, not the FAST solution
• Identifies patterns that work but could be better
• Provides migration paths from current to optimal state

Requirements

• Claude Code CLI
• Claude Pro or Max subscription (Sonnet/Opus)
• Optional: Codex CLI, Gemini CLI

License

MIT