Skip to content

Get started

Five minutes, no model, no network, no cost: run the example loop, steer it from the board, then point the board at your own repositories.

You need the loopcaptain command: Installation.

1. Write the example loop

loopcaptain demo

This writes a small loop into ~/.local/share/loopcaptain/demo and puts it on the board. The loop builds a dashboard on loop engineering with invented content and comes with two rounds of history.

2. Start the board

loopcaptain serve

Open the address serve prints in a browser. The board answers on this machine only, and to a browser that opened that address.

3. Steer the loop

  1. Open the loop. You see its brief, the graph of a round and the two rounds it has behind it.
  2. Press Start and tick the box. The board runs the one command the loop declares in its own loop.json; the tick is asked once per command.
  3. The loop asks a question. Answer it with one of its buttons, or in your own words.
  4. It reads your answer at its next round, converges and ends done within a minute.

A question looks like this, here from an invented loop:

Waiting for you: a loop's question with two answer buttons and a box for your own words.

That is everything a connected loop does: it says what it is, what happened and what it needs from you, and it reads what you send.

4. Watch your own repositories

loopcaptain watch ~/projects --root     # every repository under a folder
loopcaptain watch ~/projects/some-repo  # one repository

A repository shows up once it has a .loops/ folder. Watch only repositories you have read: Start runs what they declare. Setup has the details.

5. Connect a loop

Give your coding agent one of the two prompts on the home page, or follow Connect or build a loop yourself.

From a checkout

make setup && make demo && make serve

make demo writes the example into demo/ in the checkout.