# Loopcaptain

> An open protocol for agent loops and a local dashboard to monitor and steer them. A loop
> (a script, a Ralph loop, a long-running agent session) writes a few small files into
> .loops/<loop-id>/ in its own repository: loop.json, events.jsonl, inbox.jsonl. The board
> shows where each loop stands, what it cost and what waits for a person, and writes the
> person's answer, note or stop back. No dependency, no cloud, nothing leaves the machine.

## Start

- [Build a loop](https://github.com/faviens/loopcaptain/blob/main/standard/prompts/build-a-loop.md): Use Loopcaptain to build an agent loop in this repository: follow https://github.com/faviens/loopcaptain/blob/main/standard/AGENTS.md.
- [Watch the loops on this machine](https://github.com/faviens/loopcaptain/blob/main/standard/prompts/watch-my-loops.md): Connect the agent loops on this machine to the Loopcaptain board: follow https://github.com/faviens/loopcaptain/blob/main/AGENTS.md, section A.
- [Installation](https://faviens.github.io/loopcaptain/installation/): `uv tool install loopcaptain`, from PyPI; Python 3.12 or later
- [Get started](https://faviens.github.io/loopcaptain/get-started/): the example loop, free, in five minutes
- [Setup](https://faviens.github.io/loopcaptain/setup/): what the board watches, checking a loop, when a loop does not show

## The standard

- [LOOPS.md](https://github.com/faviens/loopcaptain/blob/main/standard/LOOPS.md): the protocol, the helper to paste, conformance
- [AGENTS.md for a loop](https://github.com/faviens/loopcaptain/blob/main/standard/AGENTS.md): connect a loop, or build one from nothing
- [Works with every agent](https://faviens.github.io/loopcaptain/agents/): how each coding agent adds the MCP server
- [Monitor a Ralph or shell loop](https://faviens.github.io/loopcaptain/shell-loop/): a worked loop.sh with `emit` and `inbox`
- [Questions and answers](https://faviens.github.io/loopcaptain/faq/): what a loop is, how to monitor, stop and steer one

## Optional

- [The command line](https://faviens.github.io/loopcaptain/reference/cli/)
- [The MCP tools](https://faviens.github.io/loopcaptain/reference/mcp/)
- [Security](https://faviens.github.io/loopcaptain/security/)
