gstack-upgrade

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

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

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 copies, and figure out what changed. This Skill automates the entire upgrade flow. ## Core Features & Use Cases - Install Detection: Automatically detects global-git, local-git, vendored, and vendored-global install types and applies the correct upgrade strategy. - Safe Upgrade Flow: Stashes local changes, backs up vendored copies, runs version migrations, and restores from backup if setup fails. - Update Preferences: Supports auto-upgrade mode, snoozing reminders with escalating backoff, and disabling update checks entirely. - Use Case: A developer sees an UPGRADE_AVAILABLE notice, runs the upgrade, and gets a concise summary of what changed between their old version and the new release, with any local vendored copy synced automatically. ## 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 upgrade flow, which detects your install type, fetches the latest release, runs setup, and shows a summary of changes. You can also enable auto-upgrade so future updates install automatically without prompting.

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 installs are upgraded with git fetch and reset, while vendored installs are replaced with a fresh clone and restored from backup if setup fails.

Can I disable gstack update notifications?

Yes. Choose the snooze option to postpone reminders with escalating backoff of 24 hours, 48 hours, then one week, or select never ask again to disable update checks entirely via the gstack-config setting.

What happens if the gstack upgrade fails?

The previous version is restored from the .bak backup directory and a warning is shown. For git installs, stashed local changes can be recovered with git stash pop in the skill directory.

Does gstack upgrade sync local vendored copies?

Yes. When a local vendored copy exists, it is updated from the primary install after upgrade. In team mode, the vendored copy is removed instead so the global install remains the single source of truth.