TallblokeUK

Until It Works — AI skill for Claude Code

AI community

A team of AI coding agents that keeps working until your task genuinely works, with a pixel-art workshop to watch them in.

How to install Until It Works

This entry records only its repository, not the path inside it, so there is no exact command to give. Open TallblokeUK/until-it-works and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Until It Works does

A team of AI coding agents that keeps working until your task genuinely works, with a pixel-art workshop to watch them in. Works with Claude, Codex, Mercury, Gemini, OpenRouter and local models.

Alternatives in AI

Zen MCP Server — The power of Claude Code + Gemini / OpenAI / Grok / OpenRouter / Ollama / Custom Model working as one 11.3k ★
Ralph For Claude Code — by Frank Bria - An autonomous AI development framework that enables Claude Code to work iteratively on project 8k ★
Hindsight — State-of-the-art long-term memory for AI agents by Vectorize 6.7k ★

README

Until It Works(hop)

**A team of AI coding agents that keeps working on your task until it genuinely works, and a pixel-art workshop where you can watch them do it.**

You describe a task. A planner model writes a plan and a definition of "done". Worker models build it, many passes over, or as a swarm working in parallel. Tests, a reviewer, a panel and a final judge check every change, and the work is only approved when all of them agree. If the agents get stuck, they ask you a plain question and wait.

It works with the AI tools you already have: Claude, ChatGPT (Codex), Mercury, Gemini, models through OpenRouter, and models running on your own computer. Nothing touches your files until you choose to keep the result.

![The workshop: a swarm of builders working in parallel while the judge waits](docs/images/workshop.png)

What you need

macOS or Linux
Python 3.9 or newer and git. A Mac has both once you run xcode-select --install.
At least one AI coding tool, signed in. For example Claude Code with a Claude subscription, or Codex with a ChatGPT plan. The setup screen shows which tools work with which teams.
Google Chrome or another Chromium browser. Recommended, so the workshop opens in its own window. Any browser works.

Quick start

**1. Install.**

git clone https://github.com/TallblokeUK/until-it-works.git
cd until-it-works
./install.sh

You should see `installed: mp-agent, mp-status and mp-viz in ~/.local/bin`. If it also says `~/.local/bin is not on your PATH`, add the line it shows to your shell profile and open a new terminal. (`mp-agent` is the command; the name is short for multi-pass agent.)

**2. Set up.**

mp-viz

The workshop opens at http://127.0.0.1:7788 with **SETUP** showing:

Tools: which AI tools are installed and signed in, and the exact command to fix any that aren't. Press TEST to check one really answers.
API keys: add any you want to use. They are kept i