AEGIS

Sovereign Grok-native coding agent
_{Rust · tools · Missions · project learning}

---

Why

Grok OAuth	Reuses grok login / ~/.grok/auth.json
Grok 4.5	reasoning.effort · prompt_cache_key · server tools
Tools	read / write / edit / bash / glob / grep / git / web / memory / vision
Learning	Self-heal mid-run · reflect · .aegis/ memory
Missions	Plan → Mission Control → execute → validate
Platform	Dream · readiness · factory · wiki · QA · review · automations
Nexus	Evolve · spore · compress · hardware · capability map
Binary	~16 MB Rust CLI · ~2 ms cold start · no Node runtime

Install

git clone https://github.com/denster32/aegis.git
cd aegis
./install.sh
aegis --version

grok login          # or: aegis login
aegis auth status

Quick start

aegis -p "Reply with exactly: pong"
aegis --yolo --effort low -p "Create hello.txt with hi"
aegis readiness
aegis factory
aegis missions new "add a /health endpoint"
aegis missions run <id>

CLI

Command	Purpose
aegis / -p	REPL / one-shot
aegis plan	Structured plan
aegis mission	Swarm DAG
aegis missions *	Factory Missions
aegis memory *	Project learning
aegis readiness	L1–L5 readiness
aegis factory	SDLC coverage map
aegis dream	Nightly self-improve
aegis wiki *	AutoWiki
aegis smoke	Live smoke harness (no agent loop)
aegis stress	Live stress S0–S27 (no agent loop)
aegis review	PR / local diff
aegis qa	Automated QA
aegis automation *	Schedules / events
aegis checkpoint *	Git checkpoints
aegis vision	Image describe
aegis auth / login	OAuth
aegis nexus status	Nexus organism overview
aegis evolve *	Mutation genes + fitness
aegis spore *	Viral pack / vaccinate
aegis compress	Neural summary
aegis hardware *	Host probe / throttle

Flags: --effort low|medium|high · --yolo · --sandbox · --cwd · --session · --no-learn · --stream · -v · -m

See docs/nexus.md.

Terminal UI

SpaceX / xAI monochrome: white primary · dim secondary · thin rules · geometric marks ● · ▸ ×

AEGIS  0.8.0
────────────────────────────────────────────────────────
  session         a1b2c3d4
  model           grok-4.5
  effort          medium
  mode            prompt
  cwd             /path/to/project
────────────────────────────────────────────────────────
›

Architecture

aegis (CLI)
  ├── aegis-core         agent · missions · dream · factory · ui
  ├── aegis-auth         Grok OAuth
  ├── aegis-xai          Responses API
  ├── aegis-tools        coding tools + locks + capability map
  ├── aegis-memory       .aegis/ learning · neural summary
  ├── aegis-swarm        DAG + Mission Control
  ├── aegis-evolution    mutation genes + fitness
  ├── aegis-spore        viral pack / vaccinate
  ├── aegis-hardware     host probe + throttle policy
  ├── aegis-context      workspace pack
  ├── aegis-store        SQLite sessions
  └── aegis-mcp          optional MCP

Docs

Wiki	GitHub Wiki (synced from docs/wiki/)
features.md	Feature matrix
nexus.md	Living immune system
architecture.md	Crates
xai-capabilities.md	Grok 4.5 knobs
learning.md	Memory & heal
missions.md	Factory Missions
stress.md	Live stress harness
RELEASE.md	Release / verify
SECURITY.md	Threat model
audit-2026-07-12.md	Full audit

Smoke & stress

./scripts/live_smoke.sh
./scripts/stress_test.sh

License

MIT — LICENSE