This page documents how Superpowers integrates with different AI development platforms. Each platform has unique integration requirements, tool mappings, and configuration mechanisms, but all share the same underlying skills repository.
Note on Platform Deprecation: As of June 18, 2026, Gemini CLI support has been removed following the tool's end-of-life. References to Gemini CLI are for historical context regarding v5.x and early v6.x releases.
Superpowers uses a dual repository design where a lightweight plugin shim in each platform loads and manages a shared skills repository. The plugin manifests are platform-specific, but the skills themselves are platform-agnostic.
| Platform | Manifest File | Installation Type |
|---|---|---|
| Claude Code | .claude-plugin/plugin.json | Official or Custom Marketplace |
| Codex | .codex-plugin/plugin.json | Native skill discovery / Marketplace |
| Kimi Code | kimi-plugin.json | Marketplace / Repository URL |
| Pi | pi-extension.json | Native package |
| Antigravity | agy-plugin.json | Direct Repository Install |
| Cursor | hooks-cursor.json | Plugin system |
Sources: .claude-plugin/plugin.json1-20 RELEASE-NOTES.md65-71 README.md32-187
The following diagram bridges the high-level initialization concept to the specific shell scripts and environment detection used to inject the using-superpowers bootstrap context.
Sources: hooks/hooks.json1-17 RELEASE-NOTES.md65-73 README.md72-73 README.md185-187
Claude Code is the canonical platform for Superpowers. It uses the official Claude plugin marketplace or the Superpowers-specific marketplace at obra/superpowers-marketplace.
The manifest defines the core metadata, versioning (v6.1.1), and keywords for discovery within the Claude ecosystem. .claude-plugin/plugin.json1-20
Claude Code triggers the session-start script via hooks/hooks.json on startup, clear, and compact events to ensure the using-superpowers instructions are always present.
hooks/hooks.json1-16
For details, see Claude Code Integration.
Codex support includes both a CLI and an App interface. It utilizes native skill discovery and an explicit hook configuration.
In v6.1.1, Codex uses an explicit empty hooks object (hooks: {}) in its manifest to prevent falling back to auto-discovering the Claude Code SessionStart hook, which previously caused redundant trust prompts.
RELEASE-NOTES.md5-9
The package-codex-plugin.sh script produces deterministic archives for the Codex portal, ensuring OpenAI metadata is included for every skill.
RELEASE-NOTES.md10-13
For details, see Codex Integration.
Superpowers v6.0.0 introduced support for several new platforms, each with unique bootstrapping methods.
using-superpowers bootstrap at session startup and again after context compaction. RELEASE-NOTES.md69-70 README.md185-187agy): Installs directly from the repository and runs the plugin's session-start hook from the first message. RELEASE-NOTES.md70-71 README.md64-73This diagram illustrates how platform-neutral skill requests are transformed into platform-specific tool calls across different environments.
Sources: RELEASE-NOTES.md65-71 README.md185-187 RELEASE-NOTES.md20-22
The skills-core.js shared module provides the underlying logic for skill discovery and path resolution used by non-Claude platforms.
For details, see skills-core.js Shared Module.
Refresh this wiki