gstack-upgrade

Automate gstack upgrades across global and vendored installs with rollback.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/algorithmbasics/gstack --skill gstack-upgrade-algorithmbasics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/algorithmbasics/gstack/tree/main/gstack-upgrade
Command: npx skills add https://github.com/algorithmbasics/gstack --skill gstack-upgrade-algorithmbasics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps gstack up to date by automating upgrades across global and vendored installations, surfacing what's new, and handling safe rollback when upgrades fail.

Core Features & Use Cases

  • Detects install type (global vs vendored) and upgrades accordingly.
  • Auto-upgrade mode with a persistent user preference and graceful fallback on failure.
  • Applies migrations and synchronizes any local vendored copies to maintain consistency across environments.

Quick Start

Invoke /gstack-upgrade to check for updates and apply the latest version.

Frequently Asked Questions about gstack-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade gstack to the latest version?

To upgrade gstack, invoke the upgrade command to automatically detect your installation type, apply the latest version, and run necessary migrations. The process checks VERSION files and validates changes via the CHANGELOG.

What is the difference between a global and vendored gstack installation?

A global installation applies the upgrade across your entire system, while a vendored installation synchronizes local copies. The upgrade tool detects the specific type and handles version management and migrations accordingly.

Can I automatically upgrade gstack and rollback if the migration fails?

Yes, you can enable an auto-upgrade mode with a persistent user preference. If the upgrade or migration fails, the system provides a graceful fallback and handles safe rollback to maintain consistency.

What do I need to check before running a gstack update?

Before updating, ensure the tool has access to your installation directory, Git, and setup scripts. These dependencies are required to validate versions via VERSION files and apply migrations during the upgrade.

How does the gstack upgrade show what's new after updating?

After completing the upgrade, the tool surfaces what's new by validating the applied version against the CHANGELOG. This ensures you immediately see the latest features and migration changes.