Skip to content
Documentation

anneal

A local-first coding agent that learns from its sessions and improves its own harness.

Using anneal

Install git clone https://github.com/uidbz/anneal cd anneal make build # bin/anneal, bin/anneal-headless, bin/anneald make install …

Read →
Configuration

config.json lives in ~/.anneal (or ANNEAL_HOME). The Settings view edits it with live changes; Edit JSON opens the raw file. …

Read →
Architecture

anneal is divided into a core that has no UI, a wire protocol, and two front ends (the Fyne desktop shell and the terminal CLI). …

Read →
Protocol

anneald speaks a versioned WebSocket protocol on /ws (and a /healthz endpoint). The desktop app, the headless CLI and any future …

Read →
Containers

The backend can run in a container with one bind mount and an idle shutdown. docker build -t anneal:dev . docker run -d --name …

Read →
Projects

anneal is one instance per project. A project has its own session list, memory files, skills, tie index and harness; the model …

Read →
Performance

anneal has a per-run timing tracer, exposed as /perf and written into the session. The source note, docs/PERFORMANCE.md, includes …

Read →