← all repositories
valkor-ai/loom

A delivery state machine for coding agents that remembers where it left off

Loom sits beside Claude Code, Codex, or OpenCode and turns big changes into a resumable loop: plan, build, verify, repair, hand off.

★1.3k stars Rust Coding AssistantsAgents
loom
Velocity · 7d
+21
★ / day
Trend
↗accelerating
star history

What it does

Loom is an open delivery harness that runs as a local MCP server (Rust) alongside your existing coding agent. Instead of letting the agent freestyle a large change, Loom drives a structured loop: clarify scope, plan, build, run checks, repair failures, preview, and leave a handoff. All state — requirements, task progress, results, repair history — lives in a project-local .loom/ directory, so a fresh session picks up the actual state of the work rather than reconstructing it from chat scrollback.

The interesting bit

The agent doesn’t decide the workflow from memory; it asks Loom for the next request, reads only the declared fields, writes the expected artifact, and submits it back. That’s a state machine wrapped around an LLM, which is a refreshingly honest way to handle agents that forget what they were doing two turns ago. Context routing also selects task-specific references instead of dumping the whole repo into every turn.

Key highlights

  • Works with Claude Code, Codex, and OpenCode through a unified @loom / /loom command surface (build, continue, review, deploy, status).
  • continue is the universal “I don’t know what step is next” action — safe after interruptions or reopened sessions.
  • Optional knowledge sources: index local docs (.md, .pdf, .docx, and more) so requirement clarification can pull in product rules and design standards.
  • MCP runtime rewritten from TypeScript to Rust for a smaller, faster core; algorithms run in an isolated Python runtime.
  • Installer verifies package checksums and refuses to overwrite files it can’t prove it owns — a rare courtesy.

Caveats

  • loom deploy requires Docker; the rest runs locally.
  • The README is heavy on command surface and light on internals — the “how it works” section cuts off mid-sentence, so you’ll need the linked technical report for the full protocol.
  • Knowledge builds can be interrupted and need an explicit resume — semantic indexing is apparently not a one-shot affair.

Verdict

Worth a look if you use coding agents for multi-session feature work and are tired of re-explaining the plan every time you reopen a chat. If your agent usage is one-shot scripts and small edits, this is machinery you don’t need.

Frequently asked

What is valkor-ai/loom?
Loom sits beside Claude Code, Codex, or OpenCode and turns big changes into a resumable loop: plan, build, verify, repair, hand off.
Is loom open source?
Yes — valkor-ai/loom is open source, released under the Apache-2.0 license.
What language is loom written in?
valkor-ai/loom is primarily written in Rust.
How popular is loom?
valkor-ai/loom has 1.3k stars on GitHub and is currently accelerating.
Where can I find loom?
valkor-ai/loom is on GitHub at https://github.com/valkor-ai/loom.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.