the manual
The operator's manual.
How to install the harness, assemble a rig, and operate the loops it runs. Sections are numbered; read them in order or jump to the part you need.
reading as an agent? start at /llms.txt; every section also exists as raw markdown at its path plus .md
looprig is an agent harness for building agents you own and can change. You choose the models, instructions, tools, permissions, storage, interface, and where the system runs.
The core mental model is small:
- A Loop defines one agent.
- A Rig assembles one or more Loops with storage and lifecycle policy.
- A Session is one running instance of that Rig.
The shared glossary defines these and the other terms used across the project.
Choose your path
| What you want to build | Begin with | Add next |
|---|---|---|
| A personal agent | Quickstart | Filesystem storage and your own instructions |
| An agent that edits files or runs commands | Loop | Tools, permissions, a workspace, and sandboxing |
| A team of agents | Rig | Delegates, delegation limits, and per-agent tools |
| A service or application | Session | HTTP serving and durable storage |
| A long-running workflow | Build larger systems | The flow module and durable checkpoints |
Ownership is part of the design
looprig does not give you one fixed agent. It gives you composable parts. Your application remains the composition root, so you decide:
- which model providers to trust;
- what each agent knows and can do;
- which actions happen automatically and which require approval;
- where session history and workspace snapshots are stored;
- whether the system runs on a laptop, server, or distributed backend;
- whether people use it through a terminal, an HTTP API, or an interface you build yourself.
Start with one useful task. Add machinery only when the task needs it.
- sec 01
Quickstart: build one agent
This guide builds a small personal assistant that accepts one request and streams its answer to the terminal.
- sec 02
Loop: define one agent
A Loop is the immutable definition of one agent.
- sec 03
Tools
Tools are capabilities you choose for a Loop.
- sec 04
Rig: assemble an agent system
A Rig is the immutable blueprint for an agent system.
- sec 05
Session: run and control a Rig
A Session is one live execution created by a Rig.
- sec 06
Build larger systems
The quickstart is already a complete looprig system.
- sec 07
Package overview
looprig is a collection of small Go modules, not one all-inclusive framework.
- sec 08
looprig Glossary
This glossary defines the shared language used across looprig's code, documentation, and public interfaces.