What problem does it solve?
Keeps a user's gstack installation up to date across different install types and environments without manual git or file-copy work, preventing drift between global and vendored copies and reducing upgrade friction and mistakes.
Core Features & Use Cases
- Install detection: Automatically detects global git installs, local git installs, vendored installs, and home-directory vendored installs and selects the correct upgrade path.
- Safe upgrade flow: Creates backups, handles git stashing/resets or vendored replacement, runs setup, and restores on failure to avoid leaving the environment broken.
- Vendored sync: Optionally synchronizes a local repository's vendored copy from the primary install so repo-embedded skills stay consistent with the global version.
- User-facing changelog summary: Reads CHANGELOG.md and summarizes user-facing changes between versions to highlight important upgrades.
- Auto-upgrade and snooze controls: Supports automatic upgrades, persistent snooze levels, and opt-out preferences to match developer workflows.
Quick Start
Run /gstack-upgrade to detect your installation, perform a safe upgrade with backups, and show a concise What's New summary.