An agentic skills framework & software development methodology that works.
Remove bootstrap CLI and related files
Drew Ritterb4f56fec1bb1
diff --git a/.codex/superpowers-bootstrap.md b/.codex/superpowers-bootstrap.mddeleted file mode 100644index 6a3b0dc36..000000000--- a/.codex/superpowers-bootstrap.md+++ /dev/null@@ -1,34 +0,0 @@-# Superpowers Bootstrap for Codex--<EXTREMELY_IMPORTANT>-You have superpowers.--**Tool for running skills:**-- `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 $HOME/.codex/superpowers/.codex/superpowers-codex use-skill` command (already available)-- `Read`, `Write`, `Edit`, `Bash` → Use your native tools with similar functions--**Skills naming:**-- Superpowers skills: `superpowers:skill-name` (from ~/.codex/superpowers/skills/)-- Personal skills: `skill-name` (from ~/.codex/skills/)-- Personal skills override superpowers skills when names match--**Critical Rules:**-- Before ANY task, review the skills list (shown below)-- 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)--**Skills location:**-- Superpowers skills: ~/.codex/superpowers/skills/-- Personal skills: ~/.codex/skills/ (override superpowers when names match)--IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.-</EXTREMELY_IMPORTANT>diff --git a/.codex/superpowers-codex b/.codex/superpowers-codexdeleted file mode 100755index 1d9a0efb6..000000000--- a/.codex/superpowers-codex+++ /dev/null@@ -1,267 +0,0 @@-#!/usr/bin/env node--const fs = require('fs');-const path = require('path');-const os = require('os');-const skillsCore = require('../lib/skills-core');--// Paths-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 superpowersRepoDir = path.join(homeDir, '.codex', 'superpowers');--// Utility functions-function printSkill(skillPath, sourceType) {- const skillFile = path.join(skillPath, 'SKILL.md');- const relPath = sourceType === 'personal'- ? path.relative(personalSkillsDir, skillPath)- : path.relative(superpowersSkillsDir, skillPath);-- // Print skill name with namespace- if (sourceType === 'personal') {- console.log(relPath.replace(/\\/g, '/')); // Personal skills are not namespaced- } else {- console.log(`superpowers:${relPath.replace(/\\/g, '/')}`); // Superpowers skills get superpowers namespace- }-- // Extract and print metadata- const { name, description } = skillsCore.extractFrontmatter(skillFile);-- if (description) console.log(` ${description}`);- console.log('');-}--// Commands-function runFindSkills() {- console.log('Available skills:');- console.log('==================');- console.log('');-- const foundSkills = new Set();-- // Find personal skills first (these take precedence)- const personalSkills = skillsCore.findSkillsInDir(personalSkillsDir, 'personal', 2);- for (const skill of personalSkills) {- const relPath = path.relative(personalSkillsDir, skill.path);- foundSkills.add(relPath);- printSkill(skill.path, 'personal');- }-- // Find superpowers skills (only if not already found in personal)- const superpowersSkills = skillsCore.findSkillsInDir(superpowersSkillsDir, 'superpowers', 1);- for (const skill of superpowersSkills) {- const relPath = path.relative(superpowersSkillsDir, skill.path);- if (!foundSkills.has(relPath)) {- printSkill(skill.path, 'superpowers');- }- }-- console.log('Usage:');- console.log(' superpowers-codex use-skill <skill-name> # Load a specific skill');- console.log('');- console.log('Skill naming:');- console.log(' Superpowers skills: superpowers:skill-name (from ~/.codex/superpowers/skills/)');- console.log(' Personal skills: skill-name (from ~/.codex/skills/)');- console.log(' Personal skills override superpowers skills when names match.');- console.log('');- console.log('Note: All skills are disclosed at session start via bootstrap.');-}--function runBootstrap() {- console.log('# Superpowers Bootstrap for Codex');- console.log('# ================================');- console.log('');-- // Check for updates (with timeout protection)- if (skillsCore.checkForUpdates(superpowersRepoDir)) {- console.log('## Update Available');- console.log('');- console.log('⚠️ Your superpowers installation is behind the latest version.');- console.log('To update, run: `cd ~/.codex/superpowers && git pull`');- console.log('');- console.log('---');- console.log('');- }-- // Show the bootstrap instructions- if (fs.existsSync(bootstrapFile)) {- console.log('## Bootstrap Instructions:');- console.log('');- try {- const content = fs.readFileSync(bootstrapFile, 'utf8');- console.log(content);- } catch (error) {- console.log(`Error reading bootstrap file: ${error.message}`);- }- console.log('');- console.log('---');- console.log('');- }-- // Run find-skills to show available skills- console.log('## Available Skills:');- console.log('');- runFindSkills();-- console.log('');- console.log('---');- console.log('');-- // Load the using-superpowers skill automatically- console.log('## Auto-loading superpowers:using-superpowers skill:');- console.log('');- runUseSkill('superpowers:using-superpowers');-- console.log('');- console.log('---');- console.log('');- console.log('# Bootstrap Complete!');- console.log('# You now have access to all superpowers skills.');- console.log('# Use "superpowers-codex use-skill <skill>" to load and apply skills.');- console.log('# Remember: If a skill applies to your task, you MUST use it!');-}--function runUseSkill(skillName) {- if (!skillName) {- console.log('Usage: superpowers-codex use-skill <skill-name>');- console.log('Examples:');- console.log(' superpowers-codex use-skill superpowers:brainstorming # Load superpowers skill');- console.log(' superpowers-codex use-skill brainstorming # Load personal skill (or superpowers if not found)');- console.log(' superpowers-codex use-skill my-custom-skill # Load personal skill');- return;- }-- // Handle namespaced skill names- let actualSkillPath;- let forceSuperpowers = false;-- if (skillName.startsWith('superpowers:')) {- // Remove the superpowers: namespace prefix- actualSkillPath = skillName.substring('superpowers:'.length);- forceSuperpowers = true;- } else {- actualSkillPath = skillName;- }-- // Remove "skills/" prefix if present- if (actualSkillPath.startsWith('skills/')) {- actualSkillPath = actualSkillPath.substring('skills/'.length);- }-- // Function to find skill file- function findSkillFile(searchPath) {- // Check for exact match with SKILL.md- const skillMdPath = path.join(searchPath, 'SKILL.md');- if (fs.existsSync(skillMdPath)) {- return skillMdPath;- }-- // Check for direct SKILL.md file- if (searchPath.endsWith('SKILL.md') && fs.existsSync(searchPath)) {- return searchPath;- }-- return null;- }-- let skillFile = null;-- // If superpowers: namespace was used, only check superpowers skills- if (forceSuperpowers) {- if (fs.existsSync(superpowersSkillsDir)) {- const superpowersPath = path.join(superpowersSkillsDir, actualSkillPath);- skillFile = findSkillFile(superpowersPath);- }- } else {- // First check personal skills directory (takes precedence)- if (fs.existsSync(personalSkillsDir)) {- const personalPath = path.join(personalSkillsDir, actualSkillPath);- skillFile = findSkillFile(personalPath);- if (skillFile) {- console.log(`# Loading personal skill: ${actualSkillPath}`);- console.log(`# Source: ${skillFile}`);- console.log('');- }- }-- // If not found in personal, check superpowers skills- if (!skillFile && fs.existsSync(superpowersSkillsDir)) {- const superpowersPath = path.join(superpowersSkillsDir, actualSkillPath);- skillFile = findSkillFile(superpowersPath);- if (skillFile) {- console.log(`# Loading superpowers skill: superpowers:${actualSkillPath}`);- console.log(`# Source: ${skillFile}`);- console.log('');- }- }- }-- // If still not found, error- if (!skillFile) {- console.log(`Error: Skill not found: ${actualSkillPath}`);- console.log('');- console.log('Available skills:');- runFindSkills();- return;- }-- // Extract frontmatter and content using shared core functions- let content, frontmatter;- try {- const fullContent = fs.readFileSync(skillFile, 'utf8');- const { name, description } = skillsCore.extractFrontmatter(skillFile);- content = skillsCore.stripFrontmatter(fullContent);- frontmatter = { name, description };- } catch (error) {- console.log(`Error reading skill file: ${error.message}`);- return;- }-- // Display skill header with clean info- const displayName = forceSuperpowers ? `superpowers:${actualSkillPath}` :- (skillFile.includes(personalSkillsDir) ? actualSkillPath : `superpowers:${actualSkillPath}`);-- const skillDirectory = path.dirname(skillFile);-- console.log(`# ${frontmatter.name || displayName}`);- if (frontmatter.description) {- console.log(`# ${frontmatter.description}`);- }- console.log(`# Skill-specific tools and reference files live in ${skillDirectory}`);- console.log('# ============================================');- console.log('');-- // Display the skill content (without frontmatter)- console.log(content);--}--// Main CLI-const command = process.argv[2];-const arg = process.argv[3];--switch (command) {- case 'bootstrap':- runBootstrap();- break;- case 'use-skill':- runUseSkill(arg);- break;- case 'find-skills':- runFindSkills();- break;- default:- console.log('Superpowers for Codex');- console.log('Usage:');- console.log(' superpowers-codex bootstrap # Run complete bootstrap with all skills');- console.log(' superpowers-codex use-skill <skill-name> # Load a specific skill');- console.log(' superpowers-codex find-skills # List all available skills');- console.log('');- console.log('Examples:');- console.log(' superpowers-codex bootstrap');- console.log(' superpowers-codex use-skill superpowers:brainstorming');- console.log(' superpowers-codex use-skill my-custom-skill');- break;-}diff --git a/.codex/superpowers-codex.cmd b/.codex/superpowers-codex.cmddeleted file mode 100644index a6f5b82ee..000000000--- a/.codex/superpowers-codex.cmd+++ /dev/null@@ -1 +0,0 @@-@node "%~dp0superpowers-codex" %*