1.6 KiB
1.6 KiB
Installing Superpowers for Codex
Enable superpowers skills in Codex via native skill discovery. Just clone and symlink.
Prerequisites
- Git
Installation
-
Clone the superpowers repository:
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers -
Create the skills symlink:
mkdir -p ~/.agents/skills ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowersWindows (PowerShell):
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills" cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills" -
Restart Codex (quit and relaunch the CLI) to discover the skills.
Migrating from old bootstrap
If you installed superpowers before native skill discovery, you need to:
-
Update the repo:
cd ~/.codex/superpowers && git pull -
Create the skills symlink (step 2 above) — this is the new discovery mechanism.
-
Remove the old bootstrap block from
~/.codex/AGENTS.md— any block referencingsuperpowers-codex bootstrapis no longer needed. -
Restart Codex.
Verify
ls -la ~/.agents/skills/superpowers
You should see a symlink (or junction on Windows) pointing to your superpowers skills directory.
Updating
cd ~/.codex/superpowers && git pull
Skills update instantly through the symlink.
Uninstalling
rm ~/.agents/skills/superpowers
Optionally delete the clone: rm -rf ~/.codex/superpowers.