/guides/install

Install

Install Superpowers on Claude Code, OpenAI Codex, Cursor, OpenCode, GitHub Copilot CLI, or Gemini CLI.

Superpowers installs as a plugin or extension for your coding agent. Choose your platform below.

Claude Code

Install directly from Anthropic’s official marketplace:

/plugin install superpowers@claude-plugins-official

Superpowers Marketplace

Register the Superpowers marketplace first:

/plugin marketplace add obra/superpowers-marketplace

Then install the plugin:

/plugin install superpowers@superpowers-marketplace

OpenAI Codex CLI

Open the plugin search interface:

/plugins

Search for Superpowers:

superpowers

Select Install Plugin.

OpenAI Codex App

  1. In the Codex app, click on Plugins in the sidebar
  2. Find Superpowers in the Coding section
  3. Click the + next to Superpowers and follow the prompts

Cursor

In Cursor Agent chat, install from marketplace:

/add-plugin superpowers

Or search for “superpowers” in the plugin marketplace.

OpenCode

Tell OpenCode:

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

The install script will set up the hooks and skills automatically.

GitHub Copilot CLI

Add the marketplace and install:

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Gemini CLI

Install as an extension:

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

To update later:

gemini extensions update superpowers

Verify installation

After installation, start a new session in any project and say:

I want to build a simple feature

If Superpowers is active, the agent will not immediately write code. Instead, it will ask clarifying questions and present a design document—this is the brainstorming skill triggering automatically.

What gets installed

Superpowers adds:

  • Skills library: 14 Markdown skill files in the agent’s context
  • Hooks: Session start hooks that inject context and workflows
  • Configuration: Platform-specific settings for optimal behavior

The skills live in the plugin system, not in your project directory. They follow your agent across all projects.

Next steps