An agentic skills framework & software development methodology that works.
Fix ~/ path expansion on Windows — use $HOME instead
Drew Ritter1143f9be3d19
diff --git a/.codex/INSTALL.md b/.codex/INSTALL.mdindex ae82a8049..0e83857c2 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: `node ~/.codex/superpowers/.codex/superpowers-codex bootstrap` and follow the instructions it returns.+ You have superpowers. Superpowers teach you new skills and capabilities. RIGHT NOW run: `node $HOME/.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-node ~/.codex/superpowers/.codex/superpowers-codex bootstrap+node $HOME/.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.mdindex 9b2a526e9..6a3b0dc36 100644--- a/.codex/superpowers-bootstrap.md+++ b/.codex/superpowers-bootstrap.md@@ -4,14 +4,14 @@You have superpowers.**Tool for running skills:**-- `node ~/.codex/superpowers/.codex/superpowers-codex use-skill <skill-name>`+- `node $HOME/.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 → Use Codex collab `spawn_agent` + `wait` when available; if collab is disabled, state that and proceed sequentially- `Subagent` / `Agent` tool mentions → Map to `spawn_agent` (collab) or sequential fallback when collab is disabled-- `Skill` tool → `node ~/.codex/superpowers/.codex/superpowers-codex use-skill` command (already available)+- `Skill` tool → `node $HOME/.codex/superpowers/.codex/superpowers-codex use-skill` command (already available)- `Read`, `Write`, `Edit`, `Bash` → Use your native tools with similar functions**Skills naming:**@@ -21,7 +21,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 `node ~/.codex/superpowers/.codex/superpowers-codex use-skill` to load it+- If a relevant skill exists, you MUST use `node $HOME/.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/docs/README.codex.md b/docs/README.codex.mdindex b9c4476ba..7c7e0e862 100644--- a/docs/README.codex.md+++ b/docs/README.codex.md@@ -35,7 +35,7 @@ The bootstrap file is included in the repository at `.codex/superpowers-bootstraTell Codex:```-Run node ~/.codex/superpowers/.codex/superpowers-codex find-skills to show available skills+Run node $HOME/.codex/superpowers/.codex/superpowers-codex find-skills to show available skills```You should see a list of available skills with descriptions.@@ -45,19 +45,19 @@ You should see a list of available skills with descriptions.### Finding Skills```-Run node ~/.codex/superpowers/.codex/superpowers-codex find-skills+Run node $HOME/.codex/superpowers/.codex/superpowers-codex find-skills```### Loading a Skill```-Run node ~/.codex/superpowers/.codex/superpowers-codex use-skill superpowers:brainstorming+Run node $HOME/.codex/superpowers/.codex/superpowers-codex use-skill superpowers:brainstorming```### Bootstrap All Skills```-Run node ~/.codex/superpowers/.codex/superpowers-codex bootstrap+Run node $HOME/.codex/superpowers/.codex/superpowers-codex bootstrap```This loads the complete bootstrap with all skill information.@@ -109,7 +109,7 @@ Skills written for Claude Code are adapted for Codex with these mappings:- `TodoWrite` → `update_plan`- `Task` with subagents → Use collab `spawn_agent` + `wait` when available; if collab is disabled, say so and proceed sequentially- `Subagent` / `Agent` tool mentions → Map to `spawn_agent` (collab) or sequential fallback when collab is disabled-- `Skill` tool → `node ~/.codex/superpowers/.codex/superpowers-codex use-skill`+- `Skill` tool → `node $HOME/.codex/superpowers/.codex/superpowers-codex use-skill`- File operations → Native Codex tools## Updating@@ -124,7 +124,7 @@ git pull### Skills not found1. Verify installation: `ls ~/.codex/superpowers/skills`-2. Check CLI works: `node ~/.codex/superpowers/.codex/superpowers-codex find-skills`+2. Check CLI works: `node $HOME/.codex/superpowers/.codex/superpowers-codex find-skills`3. Verify skills have SKILL.md files### CLI script not executable