# Show HN: Goloop – An agentic loop on your terminal

> Source: <https://mantyx-io.github.io/goloop/>
> Published: 2026-06-12 08:12:06+00:00

### 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

```
# 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
# once: provider, models, sign-in
goloop configure
goloop login

# in your project
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`