This page is the entry point for installing Superpowers on your AI coding agent platform. Because each platform uses a different integration mechanism, installation steps vary significantly by platform. For background on what Superpowers is and why these workflows exist, see the Overview. For a detailed explanation of how skills work after installation, see Core Concepts.
Superpowers supports four platforms. Two use built-in plugin marketplaces; two require manual setup via git clone and filesystem symlinks.
| Platform | Install Method | Key Manifest File | Detailed Guide |
|---|---|---|---|
| Claude Code | Plugin marketplace commands | .claude-plugin/plugin.json | Installing on Claude Code |
| Cursor | Plugin marketplace command | .cursor-plugin/plugin.json | Installing on Cursor |
| OpenCode | git clone + symlink | .opencode/plugins/superpowers.js | Installing on OpenCode |
| Codex | git clone + symlink | ~/.agents/skills/superpowers/ | Installing on Codex |
The current version is 4.3.1, as defined in .claude-plugin/plugin.json4 and .cursor-plugin/plugin.json9
Sources: README.md28-73 .claude-plugin/plugin.json1-13 .cursor-plugin/plugin.json1-18
Platform-to-install-mechanism mapping:
Sources: README.md32-73 .claude-plugin/plugin.json1-13 .cursor-plugin/plugin.json1-18
Run these two commands inside Claude Code:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
The plugin system reads the manifest at .claude-plugin/plugin.json and registers a SessionStart hook defined in hooks/hooks.json. See Installing on Claude Code for full details.
Run this command in the Cursor Agent chat:
/plugin-add superpowers
The plugin manifest is at .cursor-plugin/plugin.json See Installing on Cursor for full details.
Paste this prompt into an OpenCode session:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
This triggers a git clone and symlink setup. See Installing on OpenCode for full details.
Paste this prompt into a Codex session:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
This triggers a git clone and symlink to ~/.agents/skills/superpowers/. See Installing on Codex for full details.
Sources: README.md32-73
Session-start bootstrap path per platform:
Sources: README.md78-94 RELEASE-NOTES.md6-9 RELEASE-NOTES.md56-59 .cursor-plugin/plugin.json17
After installation, start a new session and describe a task that would trigger a skill. Examples:
brainstorming skillsystematic-debugging skillThe agent should automatically invoke the relevant skill before taking any action. If it does not, re-check the installation steps for your platform.
Skills are not invoked via explicit slash commands; they activate when the agent's using-superpowers meta-skill matches natural language descriptions to skill description fields. For details on how this matching works, see Finding and Invoking Skills.
Sources: README.md76-77 RELEASE-NOTES.md99-101
For Claude Code and Cursor, update via the plugin system:
/plugin update superpowers
For OpenCode and Codex, updating is a git pull inside the cloned repository. Platform-specific update steps are covered in each sub-page.
Sources: README.md143-148
Refresh this wiki
This wiki was recently refreshed. Please wait 3 days to refresh again.