An agentic skills framework & software development methodology that works.
Release v3.3.0: Add experimental Codex support
Jesse Vincentda9f4f1eddc7
diff --git a/codex/INSTALL.md b/.codex/INSTALL.mdsimilarity index 77%rename from codex/INSTALL.mdrename to .codex/INSTALL.mdindex 9a539d961..1250f5e07 100644--- a/codex/INSTALL.md+++ b/.codex/INSTALL.md@@ -21,7 +21,7 @@ Quick setup to enable superpowers skills in Codex.## Superpowers System<EXTREMELY_IMPORTANT>- You have superpowers. Superpowers teach you new skills and capabilities. RIGHT NOW run: `~/.codex/superpowers/scripts/superpowers-codex bootstrap` and follow the instructions it returns.+ 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>```@@ -29,7 +29,7 @@ Quick setup to enable superpowers skills in Codex.Test the installation:```bash-~/.codex/superpowers/scripts/superpowers-codex bootstrap+~/.codex/superpowers/.codex/superpowers-codex bootstrap```You should see skill listings and bootstrap instructions. The system is now ready for use.\ No newline at end of filediff --git a/codex/superpowers-bootstrap.md b/.codex/superpowers-bootstrap.mdsimilarity index 80%rename from codex/superpowers-bootstrap.mdrename to .codex/superpowers-bootstrap.mdindex 98ce278d1..18fe657f0 100644--- a/codex/superpowers-bootstrap.md+++ b/.codex/superpowers-bootstrap.md@@ -4,13 +4,13 @@You have superpowers.**Tool for running skills:**-- `~/.codex/superpowers/scripts/superpowers-codex use-skill <skill-name>`+- `~/.codex/superpowers/.codex/superpowers-codex use-skill <skill-name>`**Tool Mapping for Codex:**When skills reference tools you don't have, substitute your equivalent tools:- `TodoWrite` → `update_plan` (your planning/task tracking tool)- `Task` tool with subagents → Tell the user that subagents aren't available in Codex yet and you'll do the work the subagent would do-- `Skill` tool → `superpowers-codex use-skill` command (already available)+- `Skill` tool → `~/.codex/superpowers/.codex/superpowers-codex use-skill` command (already available)- `Read`, `Write`, `Edit`, `Bash` → Use your native tools with similar functions**Skills naming:**@@ -20,7 +20,7 @@ When skills reference tools you don't have, substitute your equivalent tools:**Critical Rules:**- Before ANY task, review the skills list (shown below)-- If a relevant skill exists, you MUST use `superpowers-codex use-skill` to load it+- If a relevant skill exists, you MUST use `~/.codex/superpowers/.codex/superpowers-codex use-skill` to load it- Announce: "I've read the [Skill Name] skill and I'm using it to [purpose]"- Skills with checklists require `update_plan` todos for each item- NEVER skip mandatory workflows (brainstorming before coding, TDD, systematic debugging)diff --git a/scripts/superpowers-codex b/.codex/superpowers-codexsimilarity index 99%rename from scripts/superpowers-codexrename to .codex/superpowers-codexindex 1665c5747..9ecc1fd1b 100755--- a/scripts/superpowers-codex+++ b/.codex/superpowers-codex@@ -8,7 +8,7 @@ const os = require('os');const homeDir = os.homedir();const superpowersSkillsDir = path.join(homeDir, '.codex', 'superpowers', 'skills');const personalSkillsDir = path.join(homeDir, '.codex', 'skills');-const bootstrapFile = path.join(homeDir, '.codex', 'superpowers', 'codex', 'superpowers-bootstrap.md');+const bootstrapFile = path.join(homeDir, '.codex', 'superpowers', '.codex', 'superpowers-bootstrap.md');// Utility functionsfunction extractFrontmatter(filePath) {diff --git a/README.md b/README.mdindex 5bbbb929a..2a614635d 100644--- a/README.md+++ b/README.md@@ -41,6 +41,12 @@ Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/# /superpowers:execute-plan - Execute plan in batches```+### Codex Installation (Experimental)++**Note:** Codex support is experimental and may require refinement based on user feedback.++Tell Codex to fetch https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md and follow the instructions.+## Quick Start### Using Slash Commandsdiff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.mdindex 48ae429aa..2c9698c4e 100644--- a/RELEASE-NOTES.md+++ b/RELEASE-NOTES.md@@ -1,5 +1,33 @@# Superpowers Release Notes+## v3.3.0 (2025-10-28)++### New Features++**Experimental Codex Support**+- Added unified `superpowers-codex` script with bootstrap/use-skill/find-skills commands+- Cross-platform Node.js implementation (works on Windows, macOS, Linux)+- Namespaced skills: `superpowers:skill-name` for superpowers skills, `skill-name` for personal+- Personal skills override superpowers skills when names match+- Clean skill display: shows name/description without raw frontmatter+- Helpful context: shows supporting files directory for each skill+- Tool mapping for Codex: TodoWrite→update_plan, subagents→manual fallback, etc.+- Bootstrap integration with minimal AGENTS.md for automatic startup+- Complete installation guide and bootstrap instructions specific to Codex++**Key differences from Claude Code integration:**+- Single unified script instead of separate tools+- Tool substitution system for Codex-specific equivalents+- Simplified subagent handling (manual work instead of delegation)+- Updated terminology: "Superpowers skills" instead of "Core skills"++### Files Added+- `codex/INSTALL.md` - Installation guide for Codex users+- `codex/superpowers-bootstrap.md` - Bootstrap instructions with Codex adaptations+- `scripts/superpowers-codex` - Unified Node.js executable with all functionality++**Note:** Codex support is experimental. The integration provides core superpowers functionality but may require refinement based on user feedback.+## v3.2.3 (2025-10-23)### Improvements