Supervisor / worker split
The planner never touches files. A dedicated worker does every edit — clean separation, predictable runs.
// open source · MIT · single static binary
A supervisor model plans every iteration. A worker — Cursor or Claude Code — does the edits. State lives in plain markdown you can read, diff, and trust. Point it at a goal; walk away.
curl -fsSL https://raw.githubusercontent.com/mantyx-io/goloop/main/scripts/install.sh | bash
.goloop/checkpoint.md
// 01 — what's inside
The planner never touches files. A dedicated worker does every edit — clean separation, predictable runs.
Supervise with ChatGPT, OpenAI, or Anthropic. Execute with Cursor CLI or Claude Code. Swap freely.
No hidden database. Progress, blockers, and the iteration log are markdown files you can diff and edit.
The loop can author its own supervisor tools, exit 75
, and auto-restart to pick them up.
When only you can answer, it stops and asks with ask_user
instead of hallucinating a decision.
Streamed worker reasoning, a live iteration log, and full-screen wizards for setup — no spinners that lie.
Models & auth once, globally. The goal per project. Flags override anything for a single run.
Written in Go. No runtime, no node_modules. curl | bash
and you're working.
// 02 — how it works
goloop configure
picks your provider, models, and signs you in — saved to ~/.goloop/config.yaml
.
goloop init
(or run
auto-init) captures the objective into the project's .goloop/config.yaml
.
goloop run .
plans, delegates, evaluates, and checkpoints until the objective is met.
{
"action": "delegate", // evaluate · ask_user ·
// delegate_tools · complete
"phase": "build",
"delegate_task": "Implement add/list/done commands",
"checkpoint_update": {
"completed": ["CLI scaffold"],
"next_steps": ["persist todos to disk"]
},
"status": "success"
}
// 03 — get started
curl -fsSL https://raw.githubusercontent.com/\
mantyx-io/goloop/main/scripts/install.sh | bash
go install github.com/mantyx-io/goloop/cmd/goloop@latest
goloop configure
goloop login
cd your-project
goloop run . --goal "Build a todo CLI"
// 04 — configuration
~/.goloop/config.yaml
Provider, models, worker, loop defaults — set once.
<dir>/.goloop/config.yaml
The objective for this repo. Required to run.
goloop run --goal …
One-off overrides for a single invocation. Free and open source under the MIT license.
curl -fsSL …/install.sh | bash