-
-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Eshan Roy edited this page Jun 16, 2026
·
4 revisions
Welcome to the comprehensive documentation for M31 Autonomous (M31A) -- the terminal-native AI coding agent that ships, not just suggests.
M31 Autonomous is a terminal-based AI coding agent written in Go. Unlike browser-bound assistants, it runs inside your shell, owns a six-phase workflow end-to-end -- Initialize, Discuss, Plan, Execute, Verify, Ship -- and commits verified changes to your git tree. One static binary, zero telemetry, any POSIX shell.
| Page | Description |
|---|---|
| Getting Started | Installation, first run, and basic setup |
| Configuration | All configuration options with examples |
| Slash Commands | Complete command reference |
| Keybindings | Keyboard shortcuts and leader keys |
| Page | Description |
|---|---|
| Architecture | High-level system design and module layout |
| Six-Phase Workflow | The Initialize-Discuss-Plan-Execute-Verify-Ship engine |
| Tools System | Built-in tools, dispatcher, permissions, and security |
| Provider System | LLM providers, model cache, fallback, and SSE streaming |
| Subagents | Parallel subagent system with git worktree isolation |
| Task Runner | Dependency-aware task scheduler with parallel execution |
| Prompt System | Embedded prompt templates and plan parsing |
| Page | Description |
|---|---|
| Code Intelligence | Source parsing, import graphs, symbol indexing, relevance scoring |
| Token Estimation | tiktoken-based counting, EMA calibration, context warnings |
| Git Integration | Git operations wrapper: commits, diffs, branches, stashing |
| Page | Description |
|---|---|
| Terminal UI | Bubble Tea TUI: 29 screens, 40+ components, themes, and layout |
| Session Management | Sessions, checkpoints, persistence, and resume |
| Prompt History | Frecent prompt history with scoring and autocomplete |
| Page | Description |
|---|---|
| Public Packages | Importable pkg/ packages: ledger, rollback, bisect, arbitrage, etc. |
| Security Model | Permission system, keychain, sandboxing, and SSRF protection |
| Error Handling | Sentinel errors and user-friendly error messages |
| Logging | Structured logging with JSON output and daily rotation |
| File Utilities | Atomic file writes for crash-safe persistence |
| Development Guide | Building, testing, linting, and contributing |
v1.0.0 -- core feature complete. V1.1 features (ghost mode, picture-in-picture, deferred tools) are on the roadmap.