Roman Peschke @roman.peschke
Free Guide

How to Install Superpowers for Claude Code

A free plugin that turns your coding agent into a brainstorming partner, architect, and autonomous dev team. Also works on Cursor, Codex, Gemini CLI, and OpenCode.

Tools you'll use

Most people use their coding agent like a fancy autocomplete. Superpowers changes that. It's a free, open-source plugin (122k+ GitHub stars, MIT license) that forces your agent to stop and think before writing code. It asks clarifying questions, writes a design doc, builds an implementation plan, dispatches sub-agents to execute each task, reviews the output, and handles branch management. Anthropic added it to the official Claude Code marketplace. It also works on Cursor, Codex, Gemini CLI, and OpenCode.

Install
1

Install Superpowers on your platform

Claude Code (official marketplace):

  • Run /plugin install superpowers@claude-plugins-official

Cursor:

  • Run /add-plugin superpowers in Agent chat, or search the plugin marketplace

Codex:

  • Tell Codex: "Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md"

Gemini CLI:

  • Run gemini extensions install https://github.com/obra/superpowers

All install methods pull from the same GitHub repo. OpenCode has its own install path documented there.

2

Verify it's working

Start a new session and ask your agent to help you plan a feature. If Superpowers is installed, it will ask clarifying questions instead of immediately writing code. That's the signal.

The workflow
3

Brainstorm before building

Describe what you want to build. The agent activates the brainstorming skill automatically. It refines your idea through questions, explores alternatives, and presents the design in chunks short enough to actually read and digest. No wall-of-text design docs.

How skills trigger

Superpowers skills activate automatically based on context. You don't run slash commands for them. The agent detects what you're doing and uses the right skill. Brainstorming fires before code. TDD fires during implementation. Code review fires between tasks.

4

Approve the design, get a plan

Once you sign off on the design, the agent writes an implementation plan. Each task is bite-sized (2-5 minutes), with exact file paths, complete code expectations, and verification steps. The plan is detailed enough that a junior engineer with no project context could follow it.

5

Sub-agents execute the work

Say "go" and the agent dispatches fresh sub-agents for each task. Each sub-agent gets a clean context window. Two-stage review on every task: first it checks spec compliance, then code quality. The agent can work autonomously for hours without deviating from the plan you approved.

6

Review, test, and ship

When all tasks are done, the agent verifies tests pass and presents your options: merge to main, create a PR, keep the branch for more work, or discard. Git worktree cleanup is automatic.

What's included
7

Full skills library

Superpowers includes 14 skills that cover the entire development lifecycle:

  • Brainstorming and writing plans for design and architecture
  • Test-driven development enforcing red-green-refactor
  • Systematic debugging with 4-phase root cause analysis
  • Sub-agent-driven development and parallel agent dispatch
  • Code review (requesting and receiving)
  • Git worktree management for isolated branches
  • Verification before completion so nothing ships unchecked

Before you start

!
Don't skip the brainstorming phase. If you paste code and say "fix this," you're bypassing the whole system. Superpowers works best when you describe what you want to achieve, not what code to write.
!
Give it 2-3 real tasks before judging. Superpowers changes how you interact with your agent. The first session will feel different. By the third, you'll see why 122k people use it.
!
Keep it updated. Superpowers is on v5.0.6 as of March 2026 and moves fast. In Claude Code, run /plugin update superpowers. In Gemini CLI, run gemini extensions update superpowers.
Start here

Open Claude Code, run /plugin install superpowers@claude-plugins-official, then say "Help me plan a new feature." Watch it ask questions instead of writing code.

Tools used in this guide

Superpowers
An agentic skills framework and software development methodology for coding agents. 14 composable skills covering brainstorming, TDD, sub-agent dispatch, code review, debugging, and git worktree management. Free, open source, MIT license. 122k+ GitHub stars.
github.com/obra/superpowers

FAQ

Is Superpowers free?
Yes. Superpowers is free and open source under the MIT license. Built by Jesse Vincent and the team at Prime Radiant. 122k+ GitHub stars.
Does Superpowers work with Cursor, Codex, or Gemini CLI?
Yes. It supports Claude Code, Cursor, Codex, OpenCode, and Gemini CLI. Each platform has its own install method. Claude Code and Cursor use their built-in plugin marketplaces. Codex, OpenCode, and Gemini CLI have separate install steps in the repo README.
What does Superpowers actually do?
It's a set of 14 composable skills that change how your coding agent works. Instead of jumping straight to code, it brainstorms with you, writes a design doc, creates an implementation plan, dispatches sub-agents to execute each task, reviews the code with a two-stage process, and handles branch management. Skills trigger automatically based on context.
Will Superpowers slow down simple tasks?
No. Skills trigger based on context. A quick one-line fix won't activate the full brainstorming and planning workflow. The heavier skills fire when you're building something substantial.