gstack-upgrade

Upgrade gstack installations across global, local, and vendored types.

Updated Jul 21, 2025
One-click install
npx skills add https://github.com/robertzengcn/aiFetchly --skill gstack-upgrade-robertzengcn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/robertzengcn/aiFetchly/tree/main/.agents/skills/gstack/gstack-upgrade
Command: npx skills add https://github.com/robertzengcn/aiFetchly --skill gstack-upgrade-robertzengcn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort and risk of updating gstack across different install types (global git, local git, vendored, vendored-global), automatically handling version checks, user consent for upgrades, backup creation, version-specific migrations, and local copy syncing so you always have the latest features without broken installs or lost data.

Core Features & Use Cases

  • Multi-install type detection: Automatically identifies whether gstack is installed as a global git repo, local git repo, vendored copy, or global vendored copy and runs the correct upgrade workflow for each.
  • Safe upgrade with rollback: Stashes local uncommitted changes for git installs, creates full backups for vendored installs, and restores the previous version automatically if the setup step fails.
  • Automated version migrations: Runs idempotent migration scripts to fix config, directory structure, and state changes between gstack versions, so you don't have to manually adjust settings after upgrading.
  • Vendored copy sync: Updates local project vendored gstack copies to match the global install, with team mode support to remove stale copies when using a shared global install as the single source of truth.
  • Use Case: If you use gstack across multiple projects with vendored copies, this Skill upgrades the global gstack install once and syncs all local copies automatically, saving you from running manual update commands in every project directory.

Quick Start

Ask your AI assistant to upgrade gstack to the latest version and show you a summary of all new changes and features.

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 safely without losing my local uncommitted changes?

To upgrade gstack safely, the tool automatically stashes local uncommitted changes for git installs and creates full backups for vendored installs. If the setup step fails, it restores the previous version automatically to ensure zero data loss.

How do I update gstack across multiple projects with vendored copies?

You can update gstack across multiple projects by upgrading the global install once. The tool then automatically syncs all local vendored copies to match the global version, saving you from running manual update commands in every project directory.

What happens to my configuration and directory structure after a gstack version upgrade?

After a gstack version upgrade, automated idempotent migration scripts execute to fix configuration, directory structure, and state changes between versions, ensuring state consistency without requiring manual adjustments.

Does gstack version management support deferred updates and auto-upgrade configuration?

Yes, gstack version management supports auto-upgrade configuration and includes snooze logic for deferred updates. It also handles version check caching and upgrade consent prompts to control when updates are applied.

Can I see what's new in a gstack update immediately after upgrading?

Yes, you can see what's new immediately after upgrading. The tool executes post-upgrade changelog summarization to provide a clear summary of all new changes and features right after the update completes.

How does gstack migration handle vendored-global installations and team mode?

For vendored-global installations, the upgrade workflow executes vendored copy syncing and enforces team mode to remove stale copies, using the shared global install as the single source of truth for state consistency.