Loom documentation
Loom runs workflows locally and records structured diagnostics. Start with the task you need to do:
Start here
| Goal | Link |
|---|---|
| Run your first workflow | Hello Loom |
| Understand the author → validate → run → diagnose loop | How Loom works |
| Diagnose a failing run | Diagnostics ladder |
| Browse the CLI | CLI overview |
| Understand artifact layout | Runtime logs contract |
Adopting Loom in a repo
- Follow Hello Loom for your first successful run
- Learn the workflow format in Syntax v1 and Workflows
- When something fails, use What to share to share the minimal evidence set
Alpha 1 support boundary
The bullets below are a short orientation. The Alpha support boundary defines Loom's claim states, evidence rules, and compatibility limits.
- Execution: local-only with
loom run --local - Target: native host jobs use
target: linuxon Linux ortarget: darwinon macOS; native Docker jobs requiretarget: linux. GitLab execution remains Linux-only. - Providers: host and Docker-backed execution today
- Agent integration: see Agent integration for MCP, Cursor skill, and agent-driven workflow setup
Site structure
| Section | What's there |
|---|---|
| Product | What Loom is, why it exists, how it works, roadmap |
| Docs | Getting started, concepts, guides, workflows, troubleshooting |
| Reference | CLI commands, workflow schema, artifact contracts |
| Knowledge Base | FAQs, patterns, and operational playbooks |