# piloop

- [Introduction](https://piloop.autoresearch.inc/index.md): piloop runs coding agents on your repo in a loop. It scores every commit and keeps what beats the best result so far.
- [Quickstart](https://piloop.autoresearch.inc/quickstart.md): Install piloop and run a campaign that compresses the first 10 MB of Wikipedia.
- [Set up your own repo](https://piloop.autoresearch.inc/setup.md): Let a coding agent set up a campaign for your repo, or set it up by hand.
- [Projects and the evaluate command](https://piloop.autoresearch.inc/concepts/projects.md): A project is a git repo with a goal that a program can measure.
- [Ideas, seeds and runs](https://piloop.autoresearch.inc/concepts/ideas-and-runs.md): An idea is what to test. A seed is a hunch that research develops into an idea. A run is one attempt at an idea.
- [Candidates, the verdict and the head](https://piloop.autoresearch.inc/concepts/verdict.md): How piloop decides whether a commit is kept.
- [Roles](https://piloop.autoresearch.inc/concepts/roles.md): The worker, the watchdog and the research agent. Every agent that piloop starts has one of these roles.
- [The orchestrator and the inbox](https://piloop.autoresearch.inc/concepts/orchestrator.md): A coding agent of your choice runs the campaign for you and records every decision in your inbox.
- [Tracks](https://piloop.autoresearch.inc/concepts/tracks.md): Several objectives for one piece of code, on one trunk.
- [Session capture with Entire](https://piloop.autoresearch.inc/concepts/session-capture.md): Keep the full session of every agent in your repo, next to the commits it made.
- [Cost and spend limits](https://piloop.autoresearch.inc/concepts/cost.md): What the agents use in tokens, and a hard limit on what the campaign spends outside piloop.
- [Running for days](https://piloop.autoresearch.inc/guides/running-for-days.md): Run the daemon in the background or under a service manager, and restart it without losing work.
- [Secrets](https://piloop.autoresearch.inc/guides/secrets.md): Give the daemon the API keys that MCP servers and the spend command need.
- [MCP servers](https://piloop.autoresearch.inc/guides/mcp-servers.md): Give the agents of a role extra tools, such as web search, with one definition for every harness.
- [Upgrading](https://piloop.autoresearch.inc/guides/upgrading.md): Upgrade the CLI, the skills and the database with one command.
- [Watching a campaign](https://piloop.autoresearch.inc/guides/watch.md): piloop watch shows the campaign on one screen, with keys to act on it.
- [Reviewing a campaign](https://piloop.autoresearch.inc/guides/reviewing.md): Check that the gains are real, that no agent gamed the evaluation, and where the time and tokens went.
- [CLI](https://piloop.autoresearch.inc/reference/cli.md): Every piloop command and its options.
- [Configuration](https://piloop.autoresearch.inc/reference/configuration.md): Every key of piloop.toml, with its type and its default.
- [Database schema](https://piloop.autoresearch.inc/reference/schema.md): The tables that piloop sql reads and writes.
- [Environment variables](https://piloop.autoresearch.inc/reference/environment.md): The environment variables that piloop reads, and the ones that it sets for the programs it runs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.