AEGIS

AI advisory board for your codebase. 6 expert advisors assess architecture, product, design, finance, security, and strategy — giving you structured, multi-perspective governance for every decision.

What It Does

AEGIS adds a virtual advisory board to your development workflow. Each advisor has distinct biases, frameworks, and pushback triggers. They disagree with each other productively, and a negotiation engine synthesizes their perspectives into actionable recommendations.

• The Architect — Technical architecture, deploy speed, blast radius
• The Product Mind — User impact, market fit, prioritization
• The Craftsperson — Design quality, UX, accessibility
• The Operator — Cost, revenue impact, resource efficiency
• The Sentinel — Security, compliance, threat modeling
• The Strategist — Vision alignment, culture, long-term strategy

Install

npm install -g aegis-ai

Connect to Claude Code (optional)

Give Claude Code 17 governance tools:

npm install -g aegis-mcp
claude mcp add --transport stdio --scope user aegis -- aegis-mcp

Quick Start

# Initialize governance in your project
cd your-project
aegis init

# Launch the dashboard
aegis dashboard

# Or use the CLI directly
aegis status
aegis retro

CLI Commands

| Command | Description | |---------|-------------| | aegis init | Initialize .aegis/ governance structure | | aegis quickstart | Interactive setup with guided prompts | | aegis dashboard | Launch web dashboard | | aegis status | Show advisory summary | | aegis validate | Schema-check all .aegis/ files | | aegis history | List decisions with filters | | aegis inspect | Run deterministic governance checks | | aegis review | Review pending recommendations | | aegis brief | Generate AI executive brief | | aegis retro | Weekly decision intelligence report | | aegis session <role> | Generate advisor session prompt | | aegis focus add | Create standing directive | | aegis skills search | Search community skills | | aegis skills install | Install a community skill | | aegis adapt | Generate CLAUDE.md governance file | | aegis export | Generate STATUS.md for git | | aegis pause | Snapshot state for next session | | aegis resume | Pick up where you left off | | aegis vision | Start strategic vision cycle |

Dashboard

The dashboard provides real-time visibility into your governance state:

• Overview — Project health, codebase metrics, decision intelligence
• Assessments — Run multi-advisor assessments (manual or live with API key)
• Advisors — View all 6 personas with biases, frameworks, triggers
• Actions — Decision history, pending proposals
• Focus Areas — Standing directives for advisors
• Strategy — SWOT analysis, priority sliders, advisor weights
• Evaluate — Feature Lab, Board Room, Priority Vote
• Skills — Community skill augmentation

How It Works

All state lives in .aegis/ — human-readable YAML files, git-friendly, fully offline.

.aegis/
  config/ceo.yaml       — project governance config
  assessments/           — advisor assessment results
  decisions/             — decision records (by tier: T1-T4)
  directives/            — focus areas / standing orders
  proposals/             — pending approval items
  retros/                — retrospective snapshots
  skills/                — community skill plugins

Decision Tiers

• T1 (Autonomous) — Bug fixes, formatting, test additions
• T2 (Notify) — New features within existing commands
• T3 (Propose) — New commands, schema changes, new dependencies
• T4 (Escalate) — Breaking changes, security-sensitive, public API

MCP Integration

When connected via aegis-mcp, Claude Code gets governance tools that let it:

• Start sessions with project context (aegis_start)
• Validate changes against governance rules (aegis_validate)
• Log decisions with proper tiering (aegis_decide)
• Review advisor recommendations (aegis_review)
• Track decision outcomes (aegis_outcomes)

Desktop App

A native desktop app (Tauri) is available for macOS, Windows, and Linux. Download from GitHub Releases.

License

FSL-1.1-MIT — Functional Source License. Free to use, modify, and self-host. Converts to MIT after 2 years. The MCP server (aegis-mcp) is MIT licensed.