gstack-upgrade

Upgrade gstack installs to the latest version with migrations and rollback recovery.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill gstack-upgrade-abdulazeezoj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/gstack-upgrade
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill gstack-upgrade-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Keeping a gstack installation current is risky when installs vary (global git checkouts, local vendored copies, team-mode setups) and when upgrades can fail mid-flight, leaving broken state, stale daemons, or lost local changes. This Skill automates the entire upgrade path safely. ## Core Features & Use Cases - Install-type detection and safe upgrade: Detects global-git, local-git, and vendored installs, then upgrades via fast-forward pull or backup-and-swap clone, with gated destructive resets and automatic restore on failure. - Versioned migrations: Runs idempotent bash migration scripts between the old and new versions to fix config keys, directory structures, poisoned browser caches, and stale skill installs. - Post-upgrade housekeeping: Stops stale browse daemons running the old binary, syncs local vendored copies, clears update caches, and summarizes the changelog. - Use Case: After being notified that gstack v1.67 is available while on v1.60, invoke the upgrade to pull the new version, run all intermediate migrations, restart stale daemons, and see a summary of what changed. ## Quick Start Ask the assistant 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 run /gstack-upgrade. It detects your install type, pulls or clones the latest release, runs setup and migrations, then shows a summary of what changed between versions.

How do I enable automatic gstack upgrades?

Set auto_upgrade to true with gstack-config set auto_upgrade true, or choose "Always keep me up to date" when the upgrade prompt appears. Future updates then install automatically without asking.

What happens if a gstack upgrade fails partway through?

Vendored installs restore from a .bak backup automatically, and git installs stop with the pre-upgrade commit recorded instead of forcing a destructive reset. Failed migrations stay pending and retry on the next upgrade run.

Does gstack-upgrade handle local vendored copies in a project?

Yes. After upgrading the primary install it checks for a local .claude/skills/gstack copy. In team mode it removes the vendored copy; otherwise it syncs the local copy from the freshly upgraded primary install.

Why does gstack-upgrade ask before running git reset?

A hard reset destroys unpushed local commits and dirty files. The skill only resets automatically when the tree is provably clean; otherwise it lists exactly what would be discarded and asks for explicit confirmation.