Installation differs by platform. Claude Code and Cursor have built-in plugin marketplaces. OpenCode uses a plugin array in opencode.json. Codex and Gemini CLI have their own install mechanisms.
Superpowers is available on the official Claude plugin marketplace. Run this command in Claude Code:/plugin install superpowers@claude-plugins-official
This is the recommended install path for Claude Code users. If you prefer to install from the community marketplace, register it first, then install Superpowers:Register the marketplace
/plugin marketplace add obra/superpowers-marketplace
Install the plugin
/plugin install superpowers@superpowers-marketplace
In Cursor’s agent chat, run:Alternatively, search for “superpowers” in the Cursor plugin marketplace and install from there. Add Superpowers to the plugin array in your opencode.json. This can be your global config (~/.config/opencode/opencode.json) or a project-level file.{
"plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}
Restart OpenCode. The plugin auto-installs via Bun and registers all skills automatically.To pin a specific version, append the tag: superpowers@git+https://github.com/obra/superpowers.git#v5.0.3
Migrating from the old symlink-based installIf you previously installed Superpowers using git clone and symlinks, remove the old setup first:rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
rm -rf ~/.config/opencode/superpowers
Also remove any skills.paths entry in your opencode.json that pointed to the old clone, then follow the install steps above. Tell Codex:Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
Codex will clone the repository and create the required symlink in ~/.agents/skills/superpowers. Skills are then discovered automatically at startup through Codex’s native skill discovery.For subagent skills (optional)Skills like dispatching-parallel-agents and subagent-driven-development require Codex’s multi-agent feature. Add this to your Codex config:[features]
multi_agent = true
WindowsIf you prefer to install manually on Windows, use a junction instead of a symlink:New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"
Install Superpowers as a Gemini extension:gemini extensions install https://github.com/obra/superpowers
Gemini CLI loads skill metadata at session start and activates the full skill content on demand via the activate_skill tool.
Verify installation
Start a new session in your chosen platform and ask for something that requires a skill:
Tell me about your superpowers
or
Help me plan this feature
The agent should describe the skills available or automatically invoke the brainstorming skill. If nothing happens, see the troubleshooting notes for your platform below.
If you installed on OpenCode, you can also run use skill tool to list skills to confirm all Superpowers skills are discovered.
Updating
Claude Code and Cursor:
/plugin update superpowers
OpenCode:
Superpowers updates automatically when you restart OpenCode — the plugin is re-fetched from the git repository on each launch.
Codex:
cd ~/.codex/superpowers && git pull
Gemini CLI:
gemini extensions update superpowers