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.