// open source · MIT · single static binary

The agentic loop,
on the command line.

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

Get started Star on GitHub

build Go 1.24+
os macOS · Linux · Windows
deps none

~/your-project — goloop run .

supervisor plans the move, emits a JSON action

worker edits the repo via Cursor / Claude Code

checkpoint writes .goloop/checkpoint.md

// 01 — what's inside

Built for autonomous coding,
not for a demo.

Supervisor / worker split

The planner never touches files. A dedicated worker does every edit — clean separation, predictable runs.

Pluggable backends

Supervise with ChatGPT, OpenAI, or Anthropic. Execute with Cursor CLI or Claude Code. Swap freely.

State you can read

No hidden database. Progress, blockers, and the iteration log are markdown files you can diff and edit.

Self-extending tools

The loop can author its own supervisor tools, exit 75, and auto-restart to pick them up.

Human in the loop

When only you can answer, it stops and asks with ask_user instead of hallucinating a decision.

Honest terminal UI

Streamed worker reasoning, a live iteration log, and full-screen wizards for setup — no spinners that lie.

Layered config

Models & auth once, globally. The goal per project. Flags override anything for a single run.

One static binary

Written in Go. No runtime, no node_modules. curl | bash and you're working.

// 02 — how it works

Read checkpoint. Decide. Act.

01

Configure once

goloop configure picks your provider, models, and signs you in — saved to ~/.goloop/config.yaml.
02

Set a goal

goloop init (or run auto-init) captures the objective into the project's .goloop/config.yaml.
03

Let it loop

goloop run . plans, delegates, evaluates, and checkpoints until the objective is met.

// supervisor action — every iteration

{
  "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

Running in under a minute.

install

# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/\
mantyx-io/goloop/main/scripts/install.sh | bash

# …or with Go
go install github.com/mantyx-io/goloop/cmd/goloop@latest

configure & run

# once: provider, models, sign-in
goloop configure
goloop login

# in your project
cd your-project
goloop run . --goal "Build a todo CLI"

// supervisors

ChatGPT subscription OpenAI API Anthropic API

// workers

Cursor CLI Claude Code

// 04 — configuration

Plain YAML. Three layers.

global ~/.goloop/config.yaml Provider, models, worker, loop defaults — set once.

project <dir>/.goloop/config.yaml The objective for this repo. Required to run.

run goloop run --goal … One-off overrides for a single invocation.

Give your terminal a goal.

Free and open source under the MIT license.

❯ curl -fsSL …/install.sh | bash

Get it on GitHub

The agentic loop,on the command line.