{"slug": "show-hn-goloop-an-agentic-loop-on-your-terminal", "title": "Show HN: Goloop – An agentic loop on your terminal", "summary": "Goloop, an open-source agentic loop tool for the terminal, uses a supervisor/worker split where a planner never touches files and a dedicated worker performs all edits. The tool, available as a single static binary under the MIT license, stores state in plain markdown files and supports swapping between ChatGPT, OpenAI, or Anthropic for supervision and Cursor CLI or Claude Code for execution. Users can run the tool with a single curl command, configure providers and models globally, and set project-specific goals to automate iterative development tasks.", "body_md": "### Supervisor / worker split\n\nThe planner never touches files. A dedicated worker does every edit — clean separation, predictable runs.\n\n// open source · MIT · single static binary\n\nA *supervisor* model plans every iteration. A *worker* — Cursor or\nClaude Code — does the edits. State lives in plain markdown you can read, diff, and\ntrust. Point it at a goal; walk away.\n\n`curl -fsSL https://raw.githubusercontent.com/mantyx-io/goloop/main/scripts/install.sh | bash`\n\n`.goloop/checkpoint.md`\n\n// 01 — what's inside\n\nThe planner never touches files. A dedicated worker does every edit — clean separation, predictable runs.\n\nSupervise with ChatGPT, OpenAI, or Anthropic. Execute with Cursor CLI or Claude Code. Swap freely.\n\nNo hidden database. Progress, blockers, and the iteration log are markdown files you can diff and edit.\n\nThe loop can author its own supervisor tools, exit `75`\n\n, and auto-restart to pick them up.\n\nWhen only you can answer, it stops and asks with `ask_user`\n\ninstead of hallucinating a decision.\n\nStreamed worker reasoning, a live iteration log, and full-screen wizards for setup — no spinners that lie.\n\nModels & auth once, globally. The goal per project. Flags override anything for a single run.\n\nWritten in Go. No runtime, no node_modules. `curl | bash`\n\nand you're working.\n\n// 02 — how it works\n\n`goloop configure`\n\npicks your provider, models, and signs you in — saved to `~/.goloop/config.yaml`\n\n.\n\n`goloop init`\n\n(or `run`\n\nauto-init) captures the objective into the project's `.goloop/config.yaml`\n\n.\n\n`goloop run .`\n\nplans, delegates, evaluates, and checkpoints until the objective is met.\n\n```\n{\n  \"action\": \"delegate\",        // evaluate · ask_user ·\n                              // delegate_tools · complete\n  \"phase\":  \"build\",\n  \"delegate_task\": \"Implement add/list/done commands\",\n  \"checkpoint_update\": {\n    \"completed\":  [\"CLI scaffold\"],\n    \"next_steps\": [\"persist todos to disk\"]\n  },\n  \"status\": \"success\"\n}\n```\n\n// 03 — get started\n\n```\n# macOS / Linux / WSL\ncurl -fsSL https://raw.githubusercontent.com/\\\nmantyx-io/goloop/main/scripts/install.sh | bash\n\n# …or with Go\ngo install github.com/mantyx-io/goloop/cmd/goloop@latest\n# once: provider, models, sign-in\ngoloop configure\ngoloop login\n\n# in your project\ncd your-project\ngoloop run . --goal \"Build a todo CLI\"\n```\n\n// 04 — configuration\n\n`~/.goloop/config.yaml`\n\nProvider, models, worker, loop defaults — set once.\n`<dir>/.goloop/config.yaml`\n\nThe objective for this repo. Required to run.\n`goloop run --goal …`\n\nOne-off overrides for a single invocation.\nFree and open source under the MIT license.\n\n`curl -fsSL …/install.sh | bash`", "url": "https://wpnews.pro/news/show-hn-goloop-an-agentic-loop-on-your-terminal", "canonical_source": "https://mantyx-io.github.io/goloop/", "published_at": "2026-06-12 08:12:06+00:00", "updated_at": "2026-06-12 08:49:18.705553+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "ai-products", "ai-startups", "large-language-models"], "entities": ["Goloop", "ChatGPT", "OpenAI", "Anthropic", "Cursor", "Claude Code", "MIT", "Go"], "alternates": {"html": "https://wpnews.pro/news/show-hn-goloop-an-agentic-loop-on-your-terminal", "markdown": "https://wpnews.pro/news/show-hn-goloop-an-agentic-loop-on-your-terminal.md", "text": "https://wpnews.pro/news/show-hn-goloop-an-agentic-loop-on-your-terminal.txt", "jsonld": "https://wpnews.pro/news/show-hn-goloop-an-agentic-loop-on-your-terminal.jsonld"}}