Behavior-first coding agent for local models. Your thread through the labyrinth.
curl -fsSL https://install.aricode.dev | sh
Aricode.dmg
↓
One command. No dependencies, no config files, no accounts. Runs anywhere Node runs.
aricode maps your codebase into a persistent knowledge graph. Files, symbols, imports, relationships — all indexed.
Start a dream session. aricode explores autonomously — finding patterns, spotting issues, imagining where the code could go.
aricode gives local models the tools, memory, and safety to work autonomously on real codebases. Every edit is analyzed. Every command is gated. Every session builds lasting knowledge.
Tracks files, symbols, imports, runtime relationships, and mirrors across sessions. Your codebase architecture, remembered.
Phased codebase exploration (Light Sleep, REM, Deep Sleep) while you're away. Returns with architectural insights and updated knowledge.
Spawns general, explore, and plan agents for complex multi-file tasks. Parallel execution with enforced safety limits.
Routes larger tasks through a master planner that dispatches bounded section agents, retries malformed dispatches, and keeps work inside declared ownership boundaries.
Extracts test witnesses and compiles behavior patches. Understands not just what code does, but what it's supposed to do.
Every edit triggers post-analysis: linting, convention checks, blast radius reporting, and regression guards.
Three-tier allowlist: read-only auto-approved, mutating requires consent, privileged needs explicit opt-in. Env vars sanitized.
Event-driven automation on post-edit, post-write, pre-command, and session lifecycle. Wire up your own workflows.
A transcript-first terminal UI with stable input handling, normal scrollback, copyable selections, and overlays that behave like a real developer tool instead of a full-screen toy.
Any OpenAI-compatible API. Native Ollama. Your models, your hardware, your data. No cloud required.
aricode # then /init and /dream in the REPL
Initialize your project and let aricode explore. Read the full guide →