loops GitHub

Multi-agent terminal runtime

Run teams, not one agent at a time.

Loops turns project files into a live agent team with an orchestrator, coworkers, task updates, and clean handoffs.

loops --team --cwd . ready

Team

4 active

orchestrator

splits work, checks blockers

claudeCode

frontend-dev

implements focused UI slices

codex

qa-engineer

runs checks and acceptance notes

opencode

docs-specialist

keeps run context readable

claudeCode

Group channel

turn 07

orchestrator Task snapshot loaded from tasks.md.

orchestrator frontend-dev owns the CLI chrome cleanup.

frontend-dev Working in packages/cli/src/tui.

qa-engineer Waiting for changed paths before checks.

Tasks

3/5 done
  1. Project contract approved
  2. Provider models selected
  3. CLI chrome cleanup
  4. Website team runtime UI
  5. Final deploy check
orchestrator -> claudeCode implementation -> codex review -> opencode

orchestratorCoordinates work and decides when a run is complete.

coworkersImplement, review, document, and report focused slices.

handoffsTask updates and changed paths stay attached to the run.

Team

Every role has a job, a provider, and a next turn.

lead

Orchestrate

The lead reads the contract, assigns task IDs, and asks only the questions that unblock the run.

build

Execute

Coworkers make one focused slice of progress, report files, and return control to the runtime.

check

Verify

Review and QA agents work from changed paths instead of scanning a mystery transcript.

A focused programming workspace with code on a laptop screen

Contract

The team starts from files, not vibes.

goal.md, plan.md, spec.md, tasks.md, and roles.json define what the run is allowed to do.

  • Auto-enter team mode when the contract exists
  • Save named teams under .loops/teams
  • Override provider models per role

Handoffs

Runs end with state the next team can use.

Deliveries, blockers, task updates, acceptance notes, and changed paths survive after the terminal scrollback is gone.

CLI chrome cleaned
Team runtime UI active
Deploy verification queued