v0.5.0 — now with autonomous dreaming

aricode

Behavior-first coding agent for local models. Your thread through the labyrinth.

Install
$ curl -fsSL https://install.aricode.dev | sh
Documentation Follow on GitHub

A real session looks like this

aricode — ~/myproject
$ aricode
╭─────────────────────────────────────╮
│ aricode v0.5.0 │
│ model qwen2.5-coder:32b │
│ context 128K tokens │
╰─────────────────────────────────────╯
/init
◆ Indexing knowledge graph...
scanned 847 files · 312 symbols · 1,204 edges
✓ Knowledge graph built in 4.2s
/dream
◈ Entering dream state...
phase: light sleep — survey & triage
budget: 120 turns · depth: deep
◈ Dreaming...

Three steps to a
smarter codebase

1

Install

One command. No dependencies, no config files, no accounts. Runs anywhere Node runs.

2

Initialize

aricode maps your codebase into a persistent knowledge graph. Files, symbols, imports, relationships — all indexed.

3

Explore

Start a dream session. aricode explores autonomously — finding patterns, spotting issues, imagining where the code could go.

Navigate any codebase
with a thread of understanding

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.

Persistent Knowledge Graph

Tracks files, symbols, imports, runtime relationships, and mirrors across sessions. Your codebase architecture, remembered.

Autonomous Dreaming

Phased codebase exploration (Light Sleep, REM, Deep Sleep) while you're away. Returns with architectural insights and updated knowledge.

Subagent Orchestration

Spawns general, explore, and plan agents for complex multi-file tasks. Parallel execution with enforced safety limits.

Behavioral Compilation

Extracts test witnesses and compiles behavior patches. Understands not just what code does, but what it's supposed to do.

Edit Intelligence

Every edit triggers post-analysis: linting, convention checks, blast radius reporting, and regression guards.

Default-Deny Safety

Three-tier allowlist: read-only auto-approved, mutating requires consent, privileged needs explicit opt-in. Env vars sanitized.

Hooks System

Event-driven automation on post-edit, post-write, pre-command, and session lifecycle. Wire up your own workflows.

Local-First, Model-Agnostic

Any OpenAI-compatible API. Native Ollama. Your models, your hardware, your data. No cloud required.

Supported Languages

JavaScript TypeScript Python Go Rust Java Kotlin Swift C C++

From install to first edit
in under a minute

$ aricode # then /init and /dream in the REPL

Initialize your project and let aricode explore. Read the full guide →