This page guides you through installing Superpowers on your AI coding agent platform. Superpowers provides a complete software development methodology built on a set of composable "skills" and initial instructions that ensure your agent uses them README.md1-5 Installation integrates the Superpowers framework with your specific environment, enabling automated workflows like TDD, systematic debugging, and subagent-driven development README.md188-204
For background on the system's purpose, see Overview. For details on the architecture, see Architecture. For how skills work after installation, see Core Concepts.
Superpowers supports multiple platforms including Claude Code, Antigravity, Cursor, OpenAI Codex, OpenCode, Kimi Code, and Pi README.md12-14 Installation methods range from official plugin marketplaces to manual setup via repository cloning. Note that Gemini CLI support was removed in v6.1.0 following Google's EOL of the tool RELEASE-NOTES.md29-31
| Platform | Install Method | Primary Config/Entry | Detailed Guide |
|---|---|---|---|
| Claude Code | Plugin marketplace | plugin.json | Installing on Claude Code |
| Antigravity | agy plugin install | hooks/hooks.json | N/A |
| Cursor | Marketplace / /add-plugin | hooks-cursor.json | Installing on Cursor |
| OpenCode | Remote INSTALL.md | opencode.json | Installing on OpenCode |
| OpenAI Codex | App/CLI Plugin search | Native discovery | Installing on Codex |
| Kimi Code | Marketplace / /plugins | plugin.json | N/A |
| Pi | pi install | Native skills | N/A |
Sources: README.md32-186 .claude-plugin/plugin.json1-20 RELEASE-NOTES.md29-31 RELEASE-NOTES.md64-71
Platform-to-install-mechanism mapping:
Sources: README.md32-186 RELEASE-NOTES.md47-49 RELEASE-NOTES.md64-71
Install from the official Claude plugin marketplace README.md36-46:
Alternatively, you can add the developer marketplace to access pre-release versions README.md48-62:
See Installing on Claude Code for full details.
Install directly from the repository. Antigravity runs the session-start hook, making Superpowers active from the first message README.md64-73:
In the Cursor Agent chat, use the marketplace command README.md101-110:
This installation utilizes the hooks-cursor.json configuration for integration. See Installing on Cursor for full details.
Tell OpenCode to fetch the installation instructions directly README.md159-170:
See Installing on OpenCode for full details.
Codex now uses native skill discovery and no longer requires a SessionStart hook RELEASE-NOTES.md26-27 For the CLI, use the plugin search interface README.md83-100:
For the App, navigate to Plugins > Coding and click the + next to Superpowers README.md75-82 See Installing on Codex for full details.
Once installed, the system enforces a mandatory skill check protocol. The agent is instructed to check for relevant skills before any task README.md204 This ensures that the agent follows structured workflows rather than ad-hoc guessing. The using-superpowers bootstrap is injected into every session to shape agent behavior RELEASE-NOTES.md16-20
Skill Discovery and Invocation Flow:
The system uses a "1% rule" where if there is even a minor chance a skill applies, the agent must invoke it README.md204 Platform-specific tools are mapped via reference files, though modern agents are increasingly vendor-neutral in their tool calls RELEASE-NOTES.md21-22 RELEASE-NOTES.md57-58
Sources: README.md204 RELEASE-NOTES.md16-22 RELEASE-NOTES.md57-58
After installation, start a new session and describe a task that should trigger a skill. The standard acceptance test for new harness support is CLAUDE.md78-82:
"Let's make a react todo list"
A working integration will auto-trigger the brainstorming skill before any code is written README.md190 CLAUDE.md89-90
Other verification points based on the basic workflow README.md188-202:
systematic-debugging skill.subagent-driven-development.Sources: README.md188-204 CLAUDE.md78-90
Superpowers updates are platform-dependent:
/plugin update superpowers/add-plugin command.Sources: README.md73 RELEASE-NOTES.md49-50