Repository navigation
Home
github-actions[bot] edited this page Nov 8, 2026
·
3 revisions
Technical documentation for the AegisBrain autonomous engineering chassis, neural memory bus, and 3-tier multi-agent governor.
This wiki provides reference specifications, system internals, protocols, configuration formats, and troubleshooting procedures.
| Chapter | Title | Summary |
|---|---|---|
| 01 | Architecture & Internals | Chassis daemon on :8765, SQLite WAL memory bus, FTS5 virtual tables, and AST graph tokens. |
| 02 | Installation & Shell Hooks | Universal installation, shell hooks (PowerShell, Bash, Zsh, Fish), and zero-elevation autostart services. |
| 03 | 3-Tier Multi-Agent Power Hierarchy | Division of Cognition: Tier 1 Senior Boss, Tier 2 Junior Bosses, Tier 3 Workers, and dynamic hardware sizing. |
| 04 | Senior Boss Escalation & Coaching | Supervision rationale, Subagent coaching loops, Escalation Dossiers, and Senior Boss Takeover. |
| 05 | Universal Agent Interchangeability | Tool-agnostic orchestration: OpenCode, Codex, Antigravity, Claude Code, and the UniversalAgentEnvelope schema. |
| 06 | Worker Cascade & Free Models | Dynamic worker discovery (opencode models, hermes fallback list), free model tagging, and Ollama failover. |
| 07 | Hands Engine & UI Testing | Headless web inspection, DOM extraction, console error trapping, Playwright UI journey runner, and stdlib fallback. |
| 08 | Neural Memory & Context Governor | Sub-50ms FTS5 memory recall (aegis recall), deterministic |
| 09 | Mobile Remote & Whisper Bridge | 24/7 Mobile Operations: Telegram (@HHAACLIBot) & WhatsApp, local Whisper audio transcription, and console injection. |
| 10 | Power Management & Caffeinate | System sleep prevention: Win32 SetThreadExecutionState continuous pulse thread, macOS caffeinate, and systemd-inhibit. |
| 11 | Role-Based Dynamic Arsenal | Archetype profiles (developer, creator, security, omni), JIT skill expansion, and Jev Decision Head. |
| 12 | 4-Decision Quality Architecture Gate | Karpathy Simplicity Doctrine, Ponytail/Unslop AI watermark stripping, Red-Team audit, and Dual-Environment sandbox. |
| 13 | Fast-Path Testing & AST Verification | In-memory AST verification (aegis test <file>), scoped pytest execution (< 1s), and CI parity maintenance. |
| 14 | CLI Reference Bible | Exhaustive dictionary of all 58+ commands, subcommands, arguments, flags, options, and exit codes. |
| 15 | Troubleshooting & Diagnostics | System troubleshooting table: error messages, root causes, diagnostic recipes (aegis doctor), and recoveries. |
Depending on your integration objective, consult the following curated sequences:
Focus on cognitive division, token arbitrage, and cross-model orchestration:
- 01. Architecture & Internals
- 03. 3-Tier Multi-Agent Power Hierarchy
- 04. Senior Boss Escalation & Coaching
- 05. Universal Agent Interchangeability
- 12. 4-Decision Quality Architecture Gate
Focus on daemon stability, background service setup, power states, and diagnostics:
- 01. Architecture & Internals
- 02. Installation & Shell Hooks
- 10. Power Management & Caffeinate
- 13. Fast-Path Testing & AST Verification
- 15. Troubleshooting & Diagnostics
Focus on automated DOM testing, fast verification, and token savings:
- 06. Worker Cascade & Free Models
- 07. Hands Engine & UI Testing
- 08. Neural Memory & Context Governor
- 13. Fast-Path Testing & AST Verification
Focus on smartphone steering, local speech-to-text, and console injection: