2025-10-28 01:19:17 +00:00
# Installing Superpowers for Codex
2026-02-05 16:34:05 -08:00
Quick setup to enable superpowers skills in Codex. The installer links your skills into Codex's native discovery path so they load automatically.
## Prerequisites
- [Node.js ](https://nodejs.org/ ) (v16+)
- Git
2025-10-28 01:19:17 +00:00
## Installation
1. **Clone superpowers repository** :
```bash
2026-02-05 16:03:10 -08:00
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
2025-10-28 01:19:17 +00:00
` ``
2026-02-05 16:03:10 -08:00
2. **Run the installer**:
2025-10-28 01:19:17 +00:00
` ``bash
2026-02-05 16:03:10 -08:00
node ~/.codex/superpowers/.codex/install-codex.mjs
2025-10-28 01:19:17 +00:00
` ``
2026-02-05 16:34:05 -08:00
3. **Restart Codex** (quit and relaunch the CLI) to discover the skills.
**Windows:** The installer creates a junction (` mklink /J`), which works without Developer Mode.
2025-10-28 01:19:17 +00:00
2026-02-05 16:03:10 -08:00
## What the installer does
2026-02-05 16:34:05 -08:00
- Links ` ~/.agents/skills/superpowers` → ` ~/.codex/superpowers/skills` (symlink on macOS/Linux, junction on Windows)
- Adds a gatekeeper block to ` ~/.codex/AGENTS.md` that tells Codex to use superpowers skills
2026-02-05 16:03:10 -08:00
- If you had the old bootstrap setup, it removes it automatically
2026-02-05 16:34:05 -08:00
## Verify
` ``bash
ls -la ~/.agents/skills/superpowers
` ``
You should see a symlink (or junction) pointing to your superpowers skills directory.
2026-02-05 16:03:10 -08:00
## Updating
` ``bash
cd ~/.codex/superpowers && git pull
` ``
2026-02-05 16:34:05 -08:00
Skills update instantly through the link.
2025-10-28 01:19:17 +00:00
2026-02-05 16:03:10 -08:00
## Uninstalling
2025-10-28 01:19:17 +00:00
` ``bash
2026-02-05 16:03:10 -08:00
rm ~/.agents/skills/superpowers
2025-10-28 01:19:17 +00:00
` ``
2026-02-05 16:34:05 -08:00
Then remove the block between ` <!-- superpowers:begin -->` and ` <!-- superpowers:end -->` from ` ~/.codex/AGENTS.md`. Optionally delete the clone: ` rm -rf ~/.codex/superpowers`.