plan-tango

plan-tango

A Claude Code plugin that runs a Claude ↔ Codex plan-review loop on its own.
Run one command, come back to a polished plan.

---

plan-tango is a Claude Code plugin that runs a plan-review loop between Claude and Codex (gpt-5) with a single command.

More than once I've caught myself sending plans from Claude into Codex by hand. GPT's feedback is usually useful, and one round rarely closes it. So I'd write the plan, paste it into Codex, wait for the findings, bring them back to Claude, ask to apply, send the updated plan to Codex for another round, wait for the next batch of findings, bring those back. And again. Between rounds you wait, sometimes lose track of which terminal has the latest verdict and is waiting on you.

plan-tango runs that loop on its own. Claude and Codex work as a pair; the plugin passes context between them and applies fixes to the plan. Default budget is up to 6 iterations, hard cap 12. The plugin will stop sooner if there's nothing important left to flag. You stay in plan mode and can step away to do something else; when a question comes up that needs your call, the plugin pauses and asks. For time-pressed runs (or just when you have Codex quota to spare), --fast flips on Codex's priority service tier (~1.5× faster).

Install

Prerequisites: Claude Code 2.x, Node.js 18+.

1. Install Codex CLI — in your terminal (macOS/Linux) or PowerShell (Windows), outside Claude Code. One-time setup: plan-tango calls into this Codex install at runtime.

npm install -g @openai/codex
codex login

2. Install the plugin — inside a Claude Code session. The two slash commands below go directly in the chat with the agent, one per message (Claude Code treats each chat message as a single command — pasting both at once jams the second one into the URL of the first):

/plugin marketplace add egsok/plan-tango

Wait for the marketplace to be added, then:

/plugin install plan-tango@plan-tango

Or just ask the agent: "install plan-tango from github.com/egsok/plan-tango". Claude will figure out the commands and walk you through.

3. Reload plugins — in the terminal Claude Code, run /reload-plugins to pick up the new skill, scripts, and agent without leaving the session. In the VS Code extension that slash command isn't available — use Developer: Reload Window from the Command Palette (or restart Claude Code) instead.

Usage

/plan-tango:tango                          # use the active plan from plan mode
/plan-tango:tango <slug-or-path>           # or pass a specific plan file
/plan-tango:tango --fast                   # priority service tier (~1.5× faster)
/plan-tango:tango --max-iter 10 --effort medium --lenient --quiet --fresh-each

Persistent defaults live in ~/.claude/plan-tango/config.json. For an interactive wizard instead of hand-editing JSON: /plan-tango:settings.

Full reference (flag list, status codes, architecture notes) — plugins/plan-tango/README.md (English) · plugins/plan-tango/README.ru.md (Russian).

What the plugin handles beyond the loop itself