gstack-upgrade

Upgrade gstack installations across global git, local git, and vendored scenarios.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a safe, repeatable way to update the gstack skill installation across different install types (global git, local git, vendored, and vendored-global), removing the manual steps of fetching updates, running setup, syncing vendored copies, and summarizing changes for the user.

Core Features & Use Cases

  • Multi-install detection: Automatically detects whether gstack is installed as a global git, local git, vendored, or vendored-global copy and chooses the correct upgrade flow.
  • Safe upgrade with backup and restore: Stashes local changes for git installs, creates backups for vendored installs, and restores on failure to avoid leaving the workspace in a broken state.
  • Auto-upgrade and snooze controls: Honors an auto-upgrade setting, offers an interactive prompt with "Always keep me up to date" or snooze options, and persists snooze/backoff state.
  • Vendored sync: Detects and syncs a local vendored copy from the primary install and instructs users to commit updated vendored files.
  • Changelog summarization: Reads CHANGELOG.md and returns a concise, user-focused "What's new" summary after upgrading.

Quick Start

Run the gstack-upgrade skill to check for updates, perform the upgrade, and display a concise "What's new" summary.

Frequently Asked Questions about gstack-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my gstack installation to the latest version?▼

To upgrade gstack, run the gstack-upgrade skill which automatically detects your install type, fetches updates, runs setup scripts, and displays a concise changelog summary of what's new.

How does gstack handle upgrades for vendored installations?▼

For vendored installations, the upgrade creates backups before syncing changes from the primary install, automatically detects local vendored copies, and instructs you to commit the updated vendored files.

Can I auto-upgrade gstack and snooze update prompts?▼

Yes, gstack supports auto-upgrade controls by offering an interactive prompt with "Always keep me up to date" and snooze options, persisting your snooze and backoff state for future checks.

What happens if a gstack upgrade fails midway?▼

If an upgrade fails, gstack safely restores your workspace by unstashing local changes for git installs and restoring from the created backups for vendored installs to prevent a broken state.

Does upgrading gstack require host filesystem and git access?▼

Yes, upgrading gstack requires access to the host filesystem, git, and the gstack repository layout to correctly detect the install type, execute setup scripts, and manage backups.

How do I see what's new after updating gstack?▼

After updating, gstack reads the CHANGELOG.md file and returns a concise, user-focused "What's new" summary so you can quickly review the latest changes without reading the full log.