gstack-upgrade

Upgrade gstack installations and run versioned migration scripts with rollback support.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Keeping a gstack installation current is error-prone: installs can be global git clones, local git clones, or vendored copies, and each version jump may require state migrations that a plain git pull cannot handle. This Skill detects the install type, performs the upgrade safely, runs versioned migrations, and summarizes what changed. ## Core Features & Use Cases - Install-type detection and upgrade: Distinguishes global-git, local-git, vendored, and vendored-global installs, then upgrades via git reset or fresh clone with backup-and-restore on failure. - Versioned migrations: Runs idempotent bash migration scripts (v*.sh) for every version between the old and new release, covering config renames, hook registration, and state file repairs. - Update prompts with snooze and auto-upgrade: Supports interactive upgrade prompts, escalating snooze backoff (24h/48h/1 week), opt-in auto-upgrade, and permanent update-check disable. - Use Case: After invoking any gstack skill, an UPGRADE_AVAILABLE notice appears; this Skill asks whether to upgrade, updates both the global install and any local vendored copy, runs pending migrations, and shows a What's New summary from the changelog. ## Quick Start Ask the agent to upgrade gstack to the latest version and show what is new.

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?

Invoke the gstack-upgrade skill or say "upgrade gstack". It detects whether your install is a git clone or vendored copy, performs the upgrade, runs any pending version migrations, and shows a What's New summary from the changelog.

How do I enable automatic gstack upgrades?

Choose "Always keep me up to date" when the upgrade prompt appears, or run gstack-config set auto_upgrade true. Future updates then install automatically, with rollback from a backup if setup fails.

Does gstack-upgrade handle both global and vendored installs?

Yes. It detects global-git, local-git, vendored, and vendored-global installs and upgrades each appropriately. If a local vendored copy exists alongside the primary install, it syncs or removes it depending on team mode.

What happens if a gstack upgrade fails midway?

For vendored installs the previous version is restored from a .bak backup directory and a warning is shown. Migration scripts are idempotent, so re-running the upgrade safely resumes or retries incomplete steps.

How do I stop gstack update notifications?

Choose "Not now" to snooze with escalating backoff (24h, then 48h, then 1 week), or choose "Never ask again" to disable update checks entirely via gstack-config set update_check false.