gstack-upgrade

Upgrade gstack installations to the latest version and summarize changelog changes.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill gstack-upgrade-lgj-jonathan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/gstack/gstack-upgrade
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill gstack-upgrade-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping gstack up to date across global and vendored installs is error-prone: users must detect the install type, run the right upgrade commands, sync local vendored copies, and figure out what changed. This Skill automates the entire upgrade flow safely. ## Core Features & Use Cases - Install Detection: Automatically detects global-git, local-git, vendored, and vendored-global install types and upgrades each appropriately. - Safe Upgrade with Rollback: Backs up vendored installs before replacing them and restores from backup if setup fails. - Update Prompts & Snoozing: Supports auto-upgrade mode, escalating snooze backoff (24h, 48h, 1 week), and permanent opt-out via config. - Vendored Copy Sync: Detects and updates stale local vendored copies in the current repository after upgrading the primary install. - Use Case: A user runs /gstack-upgrade, the Skill detects a vendored install, clones the latest release, runs setup, syncs the local copy, and shows a summarized "What's New" from the changelog. ## Quick Start Ask the assistant to upgrade gstack to the latest version and show what changed.

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?▼

Run /gstack-upgrade or ask to upgrade gstack. The Skill detects whether your install is global-git, local-git, or vendored, then runs git fetch and reset or a fresh clone, executes setup, and shows a summary of what changed.

How does gstack detect global vs vendored installs?▼

It checks for .git directories in known locations such as ~/.claude/skills/gstack and .claude/skills/gstack. Git-based installs are upgraded via git fetch and reset, while vendored installs are replaced with a fresh shallow clone.

Can gstack upgrade automatically without prompting?▼

Yes. Set GSTACK_AUTO_UPGRADE=1 or run gstack-config set auto_upgrade true. The Skill then skips the confirmation prompt and upgrades directly, restoring from backup if setup fails.

What happens if the gstack upgrade fails during setup?▼

For vendored installs, the previous version is kept in a .bak directory and restored automatically if ./setup fails. You are warned to run /gstack-upgrade manually to retry.

How do I stop gstack update notifications?▼

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

Does gstack-upgrade update the vendored copy in my repo?▼

Yes. After upgrading the primary install, it detects a local vendored copy under .claude/skills/gstack in the current git repository and syncs it from the freshly upgraded primary install.