gstack-upgrade

Detect gstack install type and upgrade with backup, rollback, and migrations.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/uzumaki-inc/uzustack --skill gstack-upgrade-uzumaki-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/uzumaki-inc/uzustack/tree/main/_upstream/gstack/gstack-upgrade
Command: npx skills add https://github.com/uzumaki-inc/uzustack --skill gstack-upgrade-uzumaki-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading the gstack framework across different installation modes can be error-prone and manual. This Skill automates the upgrade process, detects the current install type, executes a safe upgrade, and applies version-migration steps so you stay on the latest features with minimal downtime.

Core Features & Use Cases

  • Detects install type (global git, local git, vendored) and upgrades accordingly.
  • Runs migrations and cleanups post-upgrade to preserve configurations and state.
  • Shows a concise "What’s New" summary after upgrading to aid quick validation and rollout.

Quick Start

Run the gstack upgrade command to check for updates and apply any available upgrades.

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

To upgrade gstack, execute the upgrade command to trigger install-type detection and apply the latest version. The safe, auditable flow manages backups, rollbacks, and post-upgrade migrations to keep downtime minimal.

How does gstack handle version migrations during an upgrade?

gstack manages version migrations by applying necessary cleanups and migration steps after the upgrade. This preserves your configurations and state, ensuring a seamless transition to the new version.

Can I upgrade gstack automatically across different installation types?

The upgrade tool supports auto-upgrade, manual upgrade, and migration handling across global git, local git, and vendored gstack setups. It detects the install type and applies the correct upgrade flow.

What is the best way to roll back a gstack upgrade if something goes wrong?

gstack provides a backup and rollback mechanism as part of its safe, auditable upgrade flow. If an upgrade fails, you can revert to the previous version to ensure minimal downtime.

Why should I use an automated upgrade flow for gstack instead of manual updates?

An automated upgrade flow is safer than manual updates, which are error-prone across different installation modes. It detects the install type, applies the upgrade safely, and handles version migrations automatically.

Does the gstack upgrade process work with vendored setups?

Yes, the upgrade tool works with vendored setups by detecting the installation type and applying the correct upgrade flow. It handles version migrations and cleanups to keep your vendored gstack updated safely.