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 buildBegin withAdd next
A personal agentQuickstartFilesystem storage and your own instructions
An agent that edits files or runs commandsLoopTools, permissions, a workspace, and sandboxing
A team of agentsRigDelegates, delegation limits, and per-agent tools
A service or applicationSessionHTTP serving and durable storage
A long-running workflowBuild larger systemsThe 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.

  1. sec 01

    Quickstart: build one agent

    This guide builds a small personal assistant that accepts one request and streams its answer to the terminal.

  2. sec 02

    Loop: define one agent

    A Loop is the immutable definition of one agent.

  3. sec 03

    Tools

    Tools are capabilities you choose for a Loop.

  4. sec 04

    Rig: assemble an agent system

    A Rig is the immutable blueprint for an agent system.

  5. sec 05

    Session: run and control a Rig

    A Session is one live execution created by a Rig.

  6. sec 06

    Build larger systems

    The quickstart is already a complete looprig system.

  7. sec 07

    Package overview

    looprig is a collection of small Go modules, not one all-inclusive framework.

  8. sec 08

    looprig Glossary

    This glossary defines the shared language used across looprig's code, documentation, and public interfaces.