update-superpowers

What problem does it solve?

Keeps a local superpowers-plus installation and its cascading skill chain in sync with remote repositories, ensuring updates are applied and the installed skill set is healthy and loadable.

Core Features & Use Cases

• Branch-aware updates: fetches, checks out, and updates the specified branch (main, staging, dev) or the currently checked-out branch.
• Cascading install: runs the install cascade (obra/superpowers → superpowers-plus → deployed skills) to refresh runtime skill files and tools.
• Health verification: runs diagnostic checks with sp-doctor and boots the augment layer to confirm skills load; provides guidance for common failure modes like fetch errors, dirty worktrees, and divergence.
• Use Case: A developer wants to pull the latest superpowers-plus changes on the staging branch, re-run the install cascade, and validate that all skills are deployed and reported healthy before handing the environment to a CI job.

Quick Start

Run sp-update --branch staging to pull and reinstall the specified branch, run sp-doctor to inspect installation health, restore any permission-only worktree changes, and bootstrap the augment loader to verify skills.