install-superpowers

Automated installer for Superpowers framework on OpenCode.

Installation

npx install-superpowers

Usage

Quick mode (silent install with defaults):

npx install-superpowers --quick

Interactive mode (guided wizard):

npx install-superpowers
# or
npx install-superpowers --interactive

What It Does

1. Validates prerequisites (OpenCode, git, permissions)
2. Creates backups of existing files
3. Clones superpowers repository
4. Creates symlinks for plugin and skill discovery
5. Verifies installation success

Requirements

• Node.js >= 18.0.0
• OpenCode installed
• Git installed
• Linux (macOS may also work)

🗑️ Uninstallation

Automated Uninstall (Recommended)

# Remove symlinks only (keeps cloned repo)
npx install-superpowers --uninstall

# Remove everything including the cloned repository
npx install-superpowers --uninstall --cleanup

The automated uninstall will:

• ✓ Detect if OpenCode is running (warns but continues)
• ✓ Remove symlinks with progress indicators
• ✓ Verify each removal succeeded
• ✓ Exit gracefully if nothing to uninstall

Manual Removal

If you prefer manual removal or need fine-grained control:

# Remove the cloned repository
rm -rf ~/.config/opencode/superpowers

# Remove the plugin symlink
rm ~/.config/opencode/plugins/superpowers.js

# Remove the skills symlink
rm ~/.config/opencode/skills/superpowers

Restore from Backup (if available)

# Stop OpenCode
cd ~/.config/opencode/plugins
ls -la *.backup.*  # List available backups

# Restore the most recent backup
mv superpowers.js.backup.YYYYMMDD-HHMMSS superpowers.js

# Restart OpenCode

License

MIT