gstack-upgrade

Upgrades installed gstack distributions to the latest version while preserving state.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill gstack-upgrade-tumeloramaphosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/gstack/gstack-upgrade
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill gstack-upgrade-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading gstack can be confusing because installations may be global, local, or vendored, and users need a safe way to update while preserving state and understanding what changed.

Core Features & Use Cases

  • Detects install type and location: determines whether gstack is installed globally, locally, or vendored and targets the correct upgrade directory.
  • Performs safe upgrades with recovery: upgrades via git resets/./setup for git installs or vendored-clone replacement for vendored installs, with backup/restore behavior on failures.
  • Supports upgrade migrations and version context: runs version migration scripts (when present) and summarizes user-facing updates from CHANGELOG.md.

Quick Start

Ask to upgrade gstack by saying: upgrade gstack to the latest version.

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?▼

To upgrade gstack, the system detects your installation type and runs the correct update mechanism, such as git resets or vendored-clone replacement, while keeping state consistent.

What is the difference between a global and vendored gstack upgrade?▼

A global gstack upgrade targets system-wide installations via git resets, whereas a vendored upgrade replaces team-mode cloned copies to ensure consistent version management across environments.

Does the gstack upgrade process run migration scripts automatically?▼

Yes, the gstack upgrade process executes optional version migration scripts when present, ensuring your existing state and configuration adapt correctly to the newly installed version.

How are changelog updates communicated after a gstack version upgrade?▼

After completing the gstack version upgrade, the system summarizes user-facing changes by extracting and communicating relevant release notes directly from the CHANGELOG.md file.

What happens if a gstack upgrade fails midway?▼

If a gstack upgrade fails, the system utilizes built-in backup and restore behavior to safely revert the installation directory, preventing state corruption and maintaining environment stability.

When do I need to run bash automation for a gstack update check?▼

You need bash automation for a gstack update check during user-initiated upgrade flows to detect the install type, clear update markers, and execute the appropriate version management mechanism.