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.