superpowers/.codex/INSTALL.md

Installing Superpowers for Codex

Enable superpowers skills in Codex via native skill discovery. Just clone and symlink.

Prerequisites

• Git

Installation

1. Clone the superpowers repository:

   git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
   

2. Create the skills symlink:

   mkdir -p ~/.agents/skills
   ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
   

Windows (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"

1. 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:

1. Update the repo:

   cd ~/.codex/superpowers && git pull
   

2. Create the skills symlink (step 2 above) — this is the new discovery mechanism.

3. Remove the old bootstrap block from ~/.codex/AGENTS.md — any block referencing superpowers-codex bootstrap is no longer needed.

4. 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.