gstack-upgrade

The `gstack-upgrade` skill is designed to simplify and automate the process of updating the gstack tool to its latest version. It detects whether gstack is installed globally, locally, or as a vendored copy, then executes the appropriate upgrade procedure while providing clear feedback to the user. This skill ensures that users can maintain an up-to-date development environment without manually tracking versions or worrying about potential conflicts between global and project-specific installations. By handling backups and providing restore options in case of failure, it minimizes the risk of disrupting ongoing work during upgrades.

Key features of the skill include automatic detection of the installation type, configurable auto-upgrades, and an interactive prompt for user approval when automatic updates are not enabled. It also manages version tracking by saving the previous version before performing the upgrade, provides snooze functionality for deferring updates, and allows users to disable update checks entirely. For git-based installations, it stashes any local changes, fetches the latest version from the repository, resets the local codebase, and runs the setup script, ensuring a clean and reliable upgrade process. Additionally, the skill provides feedback on the upgrade progress and version changes, helping users stay informed throughout the update.

This skill is particularly useful for developers and technical users who regularly use gstack and want to maintain the latest features and bug fixes with minimal manual effort. It is suited for both individual developers working on local projects and teams managing shared development environments. By automating upgrades, providing configurable prompts, and handling installation differences seamlessly, it reduces maintenance overhead and ensures consistency across multiple environments. Users benefit from improved productivity, reduced errors during updates, and better control over the timing and frequency of upgrades.