An agentic skills framework & software development methodology that works.
Improve README and add update checking to bootstrap
Jesse Vincent22f57e7cb0f1
diff --git a/.codex/superpowers-codex b/.codex/superpowers-codexindex 9ecc1fd1b..0066977a1 100755--- a/.codex/superpowers-codex+++ b/.codex/superpowers-codex@@ -3,14 +3,40 @@const fs = require('fs');const path = require('path');const os = require('os');+const { execSync } = require('child_process');// Pathsconst 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 checkForUpdates() {+ try {+ // Quick check with 3 second timeout to avoid delays if network is down+ const output = execSync('git fetch origin && git status --porcelain=v1 --branch', {+ cwd: superpowersRepoDir,+ timeout: 3000,+ encoding: 'utf8',+ stdio: 'pipe'+ });++ // Parse git status output to see if we're behind+ const statusLines = output.split('\n');+ for (const line of statusLines) {+ if (line.startsWith('## ') && line.includes('[behind ')) {+ return true; // We're behind remote+ }+ }+ return false; // Up to date+ } catch (error) {+ // Network down, git error, timeout, etc. - don't block bootstrap+ return false;+ }+}+function extractFrontmatter(filePath) {try {const content = fs.readFileSync(filePath, 'utf8');@@ -144,6 +170,17 @@ function runBootstrap() {console.log('# ================================');console.log('');+ // Check for updates (with timeout protection)+ if (checkForUpdates()) {+ 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 instructionsif (fs.existsSync(bootstrapFile)) {console.log('## Bootstrap Instructions:');diff --git a/README.md b/README.mdindex 2a614635d..6776255a0 100644--- a/README.md+++ b/README.md@@ -1,6 +1,6 @@# Superpowers-Give Claude Code superpowers with a comprehensive skills library of proven techniques, patterns, and workflows.+A comprehensive skills library of proven techniques, patterns, and workflows for AI coding assistants.## What You Get@@ -21,7 +21,7 @@ Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/## Installation-### Via Plugin Marketplace (Recommended)+### Claude Code (via Plugin Marketplace)```bash# In Claude Code@@ -41,7 +41,7 @@ Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/# /superpowers:execute-plan - Execute plan in batches```-### Codex Installation (Experimental)+### Codex (Experimental)**Note:** Codex support is experimental and may require refinement based on user feedback.