razorback

Razorback

Miller-powered development workflow for Claude Code, Cursor, Codex, OpenCode, Copilot CLI, and Gemini CLI.

Razorback is a skill set for every major coding-agent harness, 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.

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 / gemini / claude) and compaction-durable goldfish checkpoints; runs overnight without waking you for anything short of a real blocker

Requirements

• A supported harness: Claude Code, Cursor, Codex, OpenCode, Copilot CLI, or Gemini CLI
• 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
• Optional but recommended: repo-root RAZORBACK.md for project-specific razorback policy, such as model routing and verification tiers

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

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. Cursor marketplace submission is tracked as a follow-up — it will just be a one-liner when live.

Codex

Tell Codex:

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

Codex uses native skill discovery, so installation is a clone plus a symlink at ~/.agents/skills/razorback. Delegated execution skills (subagent-driven-development, dispatching-parallel-agents) 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

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

Copilot CLI reads the same .claude-plugin/marketplace.json that Claude Code uses. Named plugin agents (like razorback:code-reviewer) are auto-discovered.

Gemini CLI

gemini extensions install https://github.com/anortham/razorback

Gemini loads gemini-extension.json + GEMINI.md at session start, which pulls in the using-razorback skill and the Gemini tool mapping. Subagent dispatch goes through Gemini's invoke_agent tool with the built-in generalist agent (parallel by default), so subagent-driven-development and dispatching-parallel-agents work the same way they do on the other harnesses.

After Installation

Once loaded, razorback works automatically. The bootstrap path varies by harness: