razorback

Razorback

Miller-powered development workflow for Claude Code, Codex CLI / ChatGPT desktop app, and OpenCode.

Razorback is a skill set for coding-agent harnesses, diverged from Superpowers to add Miller MCP for token-efficient codebase orientation. Plan execution runs through subagent-driven-development on harnesses that support delegation, and executing-plans where delegation is unavailable.

Supported harnesses. Claude Code, Codex CLI / ChatGPT desktop app (rebranded from Codex), and OpenCode get the full plugin: skills, agents, bootstrap, and delegated execution. Cursor is frozen — its plugin support still works and is documented below, but it receives no new work. Copilot CLI is instruction-tier: it picks up razorback's Miller-first ruleset from .github/copilot-instructions.md and nothing else.

Why?

AI-assisted development burns tokens on repetitive codebase exploration. Every agent and subagent re-discovers the same code through Glob/Grep/Read chains. Razorback solves this two ways:

• Miller MCP routes all exploration through purpose-built tools — search, context, inspect, trace, impact, and workspace — that return targeted context in 1-2 calls instead of 5-8.
• Miller-first applies to every worker: the lead, implementers, reviewers, and fix workers all orient with Miller before raw file reads.
• Parallel subagent dispatch with inline review by the lead keeps the main agent's context clean while letting independent tasks move concurrently.
• Autonomous execution of approved plans with optional pre-merge external review (codex / claude) and compaction-durable goldfish checkpoints; runs overnight without waking you for anything short of a real blocker

Requirements

• A supported harness: Claude Code, Codex CLI / ChatGPT desktop app, or OpenCode — plus frozen support for Cursor
• Miller MCP — hard requirement for code orientation and symbol-aware review; must be configured and indexing your workspace
• Goldfish MCP Server — hard requirement for persistent memory (checkpoints, briefs, recall); used for compaction-durable execution during long autonomous runs
• For Codex: enable multi_agent = true in ~/.codex/config.toml so parallel execution skills can dispatch subagents

Installation

Razorback is a pure-content plugin (skills, commands, hooks) — no build step or runtime dependencies required. Install paths below are all "pull from GitHub"; most harnesses support one-liner installs.

Claude Code

/plugin marketplace add anortham/razorback
/plugin install razorback@razorback

Scope to a specific project instead of user-wide:

/plugin install razorback@razorback --scope project

Or clone and load locally for development:

git clone https://github.com/anortham/razorback.git
claude --plugin-dir /path/to/razorback

Cursor (frozen)

Cursor support is frozen: it works as documented here, but receives no new development.

Cursor has a plugin marketplace, but razorback isn't listed there yet. For now, clone and point Cursor at the local checkout via its plugin-load mechanism:

git clone https://github.com/anortham/razorback.git ~/path/to/razorback
# Then in Cursor: add ~/path/to/razorback to your plugin paths

The plugin manifest at .cursor-plugin/plugin.json declares skills, agents, commands, and hooks.

Codex CLI / ChatGPT desktop app

The ChatGPT desktop app was rebranded from Codex; both use the same install path below.

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/anortham/razorback/refs/heads/main/.codex/INSTALL.md

Preferred install: use the Codex plugin path documented in .codex/INSTALL.md. It installs razorback from the repo-scoped marketplace entry in .agents/plugins/marketplace.json, then relies on native skill discovery to load the bundled skills at startup.

Manual clone plus ~/.agents/skills/razorback symlink remains the local-development fallback. Delegated execution skills (subagent-driven-development, dispatching-parallel-agents) still require Codex's multi_agent feature.

Detailed docs: .codex/INSTALL.md

OpenCode

Tell OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/anortham/razorback/refs/heads/main/.opencode/INSTALL.md

Detailed docs: .opencode/INSTALL.md

Copilot CLI (instruction-tier)

Copilot CLI gets the Miller-first ruleset only — no skills, no agents, no delegated execution. Copy razorback's instruction-tier ruleset into the repo you work in; Copilot reads that path natively: