# loop.js

> The framework for loop engineering

## Docs

- [Agent.define](https://loop-js.mintlify.app/api/agent.md): The ungraded sibling: run the Execute phase once — no Verify, no Verdict, no convergence.
- [Exports](https://loop-js.mintlify.app/api/core.md): Everything @loop.js/core exports — the complete public surface, one line each.
- [Loop.define](https://loop-js.mintlify.app/api/define.md): Define a Loop — a pure function that turns a LoopConfig into a LoopDefinition.
- [Events](https://loop-js.mintlify.app/api/events.md): The LoopEvent stream — self-describing, replayable, observability only.
- [definition.run](https://loop-js.mintlify.app/api/run.md): Start a Run: claim the Lock, drive Rounds, and observe it through an async-iterable handle.
- [definition.status](https://loop-js.mintlify.app/api/status.md): Read one Status snapshot of a Loop from disk — no Run started, no Lock claimed.
- [loop cron](https://loop-js.mintlify.app/cli/cron.md): Install, list, and remove schedules that run `loop run` — into the OS's own scheduler or Modal.
- [loop run](https://loop-js.mintlify.app/cli/run.md): The local foreground Trigger: run the Loop in this project until it settles or a guard fires.
- [loop status](https://loop-js.mintlify.app/cli/status.md): One look at the Loop, read from disk: running? round, spend, last verdict + reason.
- [Limits](https://loop-js.mintlify.app/concepts/limits.md): Runaway guards: rounds, usd, and the per-Round timeout
- [The Loop](https://loop-js.mintlify.app/concepts/loop.md): Goal, Round, Verdict, settle — the core model of loop.js
- [Permissions](https://loop-js.mintlify.app/concepts/permissions.md): Per-phase tool gating: read, auto, bypass — the worker edits, the judge reads
- [Prompts](https://loop-js.mintlify.app/concepts/prompts.md): One Prompt shape, three forms, three homes — goal, execute, verify
- [What is loop.js](https://loop-js.mintlify.app/index.md): Loop.js is the framework for loop engineering — state a goal, the engine drives judged Rounds until an independent verdict settles it
- [What is loop engineering](https://loop-js.mintlify.app/loop-engineering.md): Designing the system that prompts an agent — and where loop.js fits in the practice
- [Quickstart](https://loop-js.mintlify.app/quickstart.md): From empty directory to a settled Goal
- [Why loop.js](https://loop-js.mintlify.app/why-loop-js.md): Claude Code already loops — /goal, /loop, and /schedule. Use them for yourself; use loop.js when the loop is a system you ship.