What problem does it solve?
This Skill eliminates the manual effort and risk of errors when updating gstack across different install types (global git, vendored, local project copies), managing auto-upgrade preferences, and running post-upgrade migrations to fix state and directory structure issues.
Core Features & Use Cases
- Multi-install type support: Automatically detects and upgrades global git, vendored, and local project gstack installs without manual configuration.
- Flexible update preferences: Lets users enable automatic upgrades, snooze reminders with escalating backoff (24h → 48h → 1 week), or disable update checks entirely.
- Vendored copy sync: Automatically updates local vendored gstack copies to match the global install, or removes stale copies when team mode is active to avoid version conflicts.
- Safe upgrade process: Creates backups before modifying installs, restores previous versions if setup fails, and runs idempotent version-specific migrations to fix state issues after upgrades.
- Use Case: If you use gstack across multiple personal or team projects, this Skill ensures all your installs stay up to date without manual git pulls, file copies, or migration work.
Quick Start
Use the gstack-upgrade skill to upgrade your gstack installation to the latest version, sync any local vendored copies, and view the latest changelog.