gstack-upgrade

Detect gstack install type and apply the appropriate upgrade workflow.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/geoffreywoo/clawfable --skill gstack-upgrade-geoffreywoo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/geoffreywoo/clawfable/tree/main/.claude/skills/gstack/gstack-upgrade
Command: npx skills add https://github.com/geoffreywoo/clawfable --skill gstack-upgrade-geoffreywoo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines the maintenance of gstack installations by automatically detecting whether the current setup is global, local, or vendored, performing upgrades, and surfacing what's new, reducing manual drift and errors.

Core Features & Use Cases

  • Detects install type (global git, local git, vendored, or vendored-global) and upgrades accordingly.
  • Syncs local vendored copies after a successful upgrade and triggers setup if needed.
  • Shows a concise changelog summary from CHANGELOG.md and reports upgrade outcomes.
  • Safe-guards with rollback steps if sync/setup fails.
  • Useful for maintainers upgrading CI agents, developers with multiple environments, and teams deploying tools in prod.

Quick Start

Run the /gstack-upgrade command to start the upgrade flow and view what's 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 automatically?

To upgrade gstack automatically, run the upgrade command to detect your install type—global git, local git, or vendored—and apply the correct update workflow. It then syncs local copies and shows what changed.

What is the best way to manage gstack version updates across multiple environments?

Managing gstack versions across environments is handled by detecting each install type and applying the appropriate upgrade workflow. It syncs local vendored copies and reports changes, reducing manual drift across setups.

How does gstack upgrade handle vendored installations?

Vendored gstack upgrades sync local copies after a successful update and trigger setup if needed. If the sync or setup fails, rollback steps are executed to restore the previous state automatically.

Can I see what changed after upgrading gstack?

Yes, after upgrading gstack, the tool reads VERSION markers and presents a concise summary from CHANGELOG.md. This reports new changes and upgrade outcomes directly in the command output.

What happens if a gstack upgrade fails during the sync process?

If a gstack upgrade fails during the sync or setup process, safe-guards trigger automatic rollback steps. This restores your environment and prevents broken installations from persisting.

Do I need specific upgrade tooling to automate gstack installation updates?

Yes, automating gstack upgrades requires upgrade tooling present in the skill directory. The tool uses these components to detect the install method and execute the appropriate version management workflow.