Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "4.0.3",
"version": "4.3.0",
"source": "./",
"author": {
"name": "Jesse Vincent",
Expand Down
28 changes: 20 additions & 8 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,25 @@
{
"name": "superpowers",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "4.0.3",
"name": "superpowers-ng",
"description": "Enhanced fork of superpowers with Manus-style persistent planning for long-running tasks and context resets",
"version": "0.1.0",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
"name": "OniReimu",
"url": "https://github.com/OniReimu"
},
"homepage": "https://github.com/obra/superpowers",
"repository": "https://github.com/obra/superpowers",
"homepage": "https://github.com/OniReimu/superpowers-ng",
"repository": "https://github.com/OniReimu/superpowers-ng",
"license": "MIT",
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows"]
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows", "manus", "planning", "persistent-memory"],
"credits": [
{
"name": "Jesse Vincent (obra)",
"role": "Original Superpowers author",
"url": "https://github.com/obra/superpowers"
},
{
"name": "Ahmad Othman Ammar Adi (OthmanAdi)",
"role": "Planning-with-files author",
"url": "https://github.com/OthmanAdi/planning-with-files"
}
]
}
71 changes: 54 additions & 17 deletions .codex/INSTALL.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,72 @@
# Installing Superpowers for Codex

Quick setup to enable superpowers skills in Codex.
Enable superpowers skills in Codex via native skill discovery. Just clone and symlink.

## Prerequisites

- Git

## Installation

1. **Clone superpowers repository**:
1. **Clone the superpowers repository:**
```bash
git clone https://github.com/OniReimu/superpowers-ng.git ~/.codex/superpowers
```

2. **Create the skills symlink:**
```bash
mkdir -p ~/.codex/superpowers
cd ~/.codex/superpowers
git clone https://github.com/obra/superpowers.git .
mkdir -p ~/.agents/skills
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers
```

**Windows (PowerShell):**
```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"
```

2. **Create personal skills directory**:
3. **Optional: Create project-local skills directory** (for per-project skills):
```bash
mkdir -p ~/.codex/skills
mkdir -p .codex/skills
```

3. **Update ~/.codex/AGENTS.md** to include this superpowers section:
```markdown
## Superpowers System
4. **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:

<EXTREMELY_IMPORTANT>
You have superpowers. Superpowers teach you new skills and capabilities. RIGHT NOW run: `~/.codex/superpowers/.codex/superpowers-codex bootstrap` and follow the instructions it returns.
</EXTREMELY_IMPORTANT>
1. **Update the repo:**
```bash
cd ~/.codex/superpowers && git pull
```

## Verification
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

```bash
ls -la ~/.agents/skills/superpowers
```

You should see a symlink (or junction on Windows) pointing to your superpowers skills directory.

## Updating

```bash
cd ~/.codex/superpowers && git pull
```

Skills update instantly through the symlink.

## Uninstalling

Test the installation:
```bash
~/.codex/superpowers/.codex/superpowers-codex bootstrap
rm ~/.agents/skills/superpowers
```

You should see skill listings and bootstrap instructions. The system is now ready for use.
Optionally delete the clone: `rm -rf ~/.codex/superpowers`.
33 changes: 0 additions & 33 deletions .codex/superpowers-bootstrap.md

This file was deleted.

Loading