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.