The command line
loopcaptain <command>; from a checkout, uv run loopcaptain <command>.
serve
The board on 127.0.0.1.
loopcaptain serve [-h] [--port PORT]
| Argument | Meaning |
|---|---|
--port |
the port on 127.0.0.1, default 8484 |
validate
Check a repository's .loops folders.
loopcaptain validate [-h] [--strict] repo
| Argument | Meaning |
|---|---|
repo |
the repository whose .loops folders are checked |
--strict |
count warnings as problems |
emit
Append one event to a loop's log, its fields as key=value pairs, for a loop in shell.
loopcaptain emit [-h] [--repo REPO] loop event [fields ...]
| Argument | Meaning |
|---|---|
loop |
the loop's id, the name of its folder in .loops/ |
event |
the event to append, one of: round_started, step_started, step_finished, finding_closed, round_finished, question, question_closed, check, inbox_read, loop_started, loop_stopped, heartbeat |
fields |
key=value; a value is read as JSON where it parses (round=2, blocks=true, ids='["a"]'), and as text where the field is text (commit=1234567) |
--repo |
the repository the loop lives in, default: this folder |
schema
Write the protocol as JSON Schema.
loopcaptain schema [-h] target
| Argument | Meaning |
|---|---|
target |
the folder the schema files are written into |
doctor
Send a loop a stop and check that it takes it and ends.
loopcaptain doctor [-h] [--timeout TIMEOUT] repo loop
| Argument | Meaning |
|---|---|
repo |
the repository the loop lives in |
loop |
the loop's id, the name of its folder in .loops/ |
--timeout |
seconds to wait, default 600 |
watch
Add a repository, or with --root a folder of them, to the board.
loopcaptain watch [-h] [--root] path
| Argument | Meaning |
|---|---|
path |
a repository, or with --root a folder of repositories |
--root |
every sub-folder with .loops/ is a repository |
unwatch
Take a folder off the board.
loopcaptain unwatch [-h] path
| Argument | Meaning |
|---|---|
path |
the folder to take off, however the config spells it |
status
Where every watched loop stands, in a terminal.
loopcaptain status [-h] [--all]
| Argument | Meaning |
|---|---|
--all |
hidden and finished loops too |
inbox
What the person sent a loop since the last call, one line each, for a loop in shell.
loopcaptain inbox [-h] [--repo REPO] [--json] loop
| Argument | Meaning |
|---|---|
loop |
the loop's id, the name of its folder in .loops/ |
--repo |
the repository the loop lives in, default: this folder |
--json |
every entry as a JSON line, with signed and stale |
hide
Take one loop off the board's first page and out of its figures.
loopcaptain hide [-h] repo loop
| Argument | Meaning |
|---|---|
repo |
the repository the loop lives in |
loop |
the loop's id, the name of its folder in .loops/ |
unhide
Show a hidden loop on the first page again.
loopcaptain unhide [-h] repo loop
| Argument | Meaning |
|---|---|
repo |
the repository the loop lives in |
loop |
the loop's id, the name of its folder in .loops/ |
demo
Write the example loop into a folder and watch it; costs nothing.
loopcaptain demo [-h] [--target TARGET] [--no-watch]
| Argument | Meaning |
|---|---|
--target |
the folder the example loop is written into, default ~/.local/share/loopcaptain/demo |
--no-watch |
write it, but leave the config alone |
mcp-config
How one coding agent adds the MCP server.
loopcaptain mcp-config [-h] [--checkout CHECKOUT] [--markdown] [agent]
| Argument | Meaning |
|---|---|
agent |
claude-code, codex, gemini, cursor, ... |
--checkout |
the folder of this repository, if run from one |
--markdown |
print the page for every agent |
spec
Print LOOPS.md, the protocol to paste into a loop.
loopcaptain spec [-h]
mcp
Run the MCP server on stdio.
loopcaptain mcp [-h]