Files

1.6 KiB

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"
    
  3. 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.