Repository Directory
Back to directory
josstei avatar
josstei / argus-claude

argus-claude

Argus - Multi-agent code quality & architecture review plugin for Claude Code. Runs parallel analysis agents with cross-validation to catch real issues, not false positives.

View on GitHub Visit website Sponsor this project

6

Stars

0

Forks

0

Watchers

MIT

License

README

Read full README on GitHub →

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