# piloop

- [Introduction](https://piloop.autoresearch.inc/index.md): You talk to one coding agent. It runs piloop for you, and piloop keeps only the commits that beat the best result so far.
- [Quickstart](https://piloop.autoresearch.inc/quickstart.md): Install piloop, open your coding agent in your repo and tell it what to improve. The agent does the rest.
- [Several campaigns](https://piloop.autoresearch.inc/several-campaigns.md): One agent runs a campaign in each of your repos, and one daemon serves all of them.
- [Run a campaign by hand](https://piloop.autoresearch.inc/by-hand.md): Set up and start a campaign with the piloop CLI, without an agent. First on the enwik8 example, then on your own repo.
- [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 head and the verdict](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, the research agent and the roles that you define. Every agent that piloop starts has a role.
- [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.
- [Overview](https://piloop.autoresearch.inc/architecture/overview.md): piloop is a daemon that runs a queue of ideas through existing coding agents, and keeps only what beats the best result so far.
- [One run's life](https://piloop.autoresearch.inc/architecture/run-lifecycle.md): What the daemon does between a ready idea and the verdict on each of its commits.
- [Data model](https://piloop.autoresearch.inc/architecture/data-model.md): The tables of the piloop database and how they relate.
- [State machines](https://piloop.autoresearch.inc/architecture/state-machines.md): The statuses of ideas, runs, agents and candidates, and the paths between them.
- [Code layout](https://piloop.autoresearch.inc/architecture/code-layout.md): The subpackages of piloop, what each one does, and how they import each other.
- [Extension points](https://piloop.autoresearch.inc/architecture/extension-points.md): Add a role, a trigger, a runtime, a harness, an MCP server or an evaluate command.
- [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.