Loom is a coding agent for your terminal. Point it at any OpenAI-compatible endpoint, hand it a goal, and it reads, edits, runs and verifies — writing every state change to an append-only journal you can replay, rewind and audit.
cargo install --path crates/loon-cli --force
Or build from source: cargo build --release → ./target/release/loom.
The default provider is a deterministic mock, so the first run needs no credentials.
Most agents ask you to trust a spinner. Loom records what happened: every message, tool call, file hash and verification result lands in a journal that the transcript is merely a projection of.
The journal is authoritative. Sessions resume to the exact context they held, and a rewrite of history is visible rather than silent. Resume lists the session you last messaged first, and file edits show their diff in the transcript.
Chat Completions and Responses protocols are both first-class. Any base URL works, including local models and gateways that support neither discovery nor tool calling.
An independent reviewer reads the goal, the plan and the evidence. It cannot accept completion while plan items are open or verification fails.
Hash-protected writes reject stale edits, patches are atomic, and every mutation keeps undo metadata. Conflicts are reported, never clobbered.
A named shell keeps its working directory and exports. Monitors stream a long-running build. SSH connections multiplex one authenticated session.
Token counts are labelled estimates until the provider reports real usage. No invented progress percentages, no fabricated speed.
These are not mockups. Each image is rendered from the real Ratatui widgets with sample data, so what you see is what the terminal draws.
The site uses the same ocean-and-thread colours the TUI ships with, so documentation and product stay recognisably one thing.
No credentials are needed to see it work; the bundled mock provider is deterministic.
Rust 1.75 or newer.
cargo build --release
./target/release/loomRuns offline against the mock provider.
loom run "Say hello" \
--output textInside the TUI, add any compatible endpoint.
/providers add local \
http://127.0.0.1:11434/v1
/model local/my-modelloom run "fix the parser" --effort high --output jsonl.
Exit codes are a documented contract — 0 completed, 1 failed, 2 cancelled,
64 usage or config error.
Generated from the repository's own Markdown, so the site cannot drift from the code.
The complete tour: providers, combos, sessions, tools, effort levels, keybindings and configuration.
Read the guide →MCP, lifecycle hooks, task dependencies, subagent profiles, plan mode and permission precedence.
Open the reference →MIT licensed. Browse the crates, the 26 embedded coding workflows and the test suite.
View on GitHub →