-
-
Notifications
You must be signed in to change notification settings - Fork 0
Home
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, leader keys, and mouse support |
| 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 |
| NVIDIA NIM Provider | NVIDIA NIM integration, setup, and configuration |
| 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 |
| CodeComplexity Tool | Codebase complexity analysis and reporting |
| 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: 31 screens, 40+ components, themes, and layout |
| Command Palette | Full-screen searchable command browser |
| Chat History | Scrollable session message browser |
| Mouse Support | Mouse wheel, click, and scrollbar interaction |
| 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, metrics, etc. |
| Metrics & Observability | Session observability pipeline: tool, LLM, and phase metrics |
| 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.1.0 -- NVIDIA NIM provider, command palette, mouse support, sidebar overhaul, LLM-based intent classification, plan chunking, research phase, session observability metrics, and 40+ fixes. Algorithmic efficiency upgrades across codeintel, tools, and TUI subsystems. Cross-platform support (Linux, macOS, Windows).