obra/superpowers

Installation

Installation differs by harness. If you use more than one, install Superpowers separately for each one.

How it works

It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it doesn't just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do.

Once it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest.

After you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY.

Next up, once you say "go", it launches a subagent-driven-development process, having agents work through each engineering task, inspecting and reviewing their work, and continuing forward. It's not uncommon for your agent to work autonomously for a couple hours at a time without deviating from the plan you put together.

Table of Contents

• How it works
• Commercial Services
• Getting Started
• Claude Code
• Antigravity
• Factory Droid
• Gemini CLI
• GitHub Copilot CLI
• Grok Build CLI
• Hermes Agent
• The Basic Workflow
• When Something Goes Wrong
• What's Inside
• Philosophy

Claude Code

Superpowers is available via the official Claude plugin marketplace

The Superpowers marketplace provides Superpowers and some other related plugins for Claude Code.

• Install the plugin from Anthropic's official marketplace:
• Register the marketplace:
• Install the plugin from this marketplace:

Codex App

Superpowers is available via the official Codex plugin marketplace.

• In the Codex app, click on Plugins in the sidebar.
• You should see Superpowers in the Coding section.
• Click the + next to Superpowers and follow the prompts.