What problem does it solve?
Provides a safe, repeatable way to update the gstack skill installation across different install types (global git, local git, vendored, and vendored-global), removing the manual steps of fetching updates, running setup, syncing vendored copies, and summarizing changes for the user.
Core Features & Use Cases
- Multi-install detection: Automatically detects whether gstack is installed as a global git, local git, vendored, or vendored-global copy and chooses the correct upgrade flow.
- Safe upgrade with backup and restore: Stashes local changes for git installs, creates backups for vendored installs, and restores on failure to avoid leaving the workspace in a broken state.
- Auto-upgrade and snooze controls: Honors an auto-upgrade setting, offers an interactive prompt with "Always keep me up to date" or snooze options, and persists snooze/backoff state.
- Vendored sync: Detects and syncs a local vendored copy from the primary install and instructs users to commit updated vendored files.
- Changelog summarization: Reads CHANGELOG.md and returns a concise, user-focused "What's new" summary after upgrading.
Quick Start
Run the gstack-upgrade skill to check for updates, perform the upgrade, and display a concise "What's new" summary.