gstack-upgrade

Upgrade gstack across global, local vendored, and vendored-global installs.

12|6|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/shogo-labs/shogo-ai --skill gstack-upgrade-shogo-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/shogo-labs/shogo-ai/tree/main/packages/agent-runtime/templates/virtual-engineering-team/.shogo/skills/gstack-gstack-upgrade
Command: npx skills add https://github.com/shogo-labs/shogo-ai --skill gstack-upgrade-shogo-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading gstack across multiple installation modes can be error-prone without consistent tooling. This Skill automates detection of global, local vendored, and vendored-global installs, performs upgrades, and applies migrations to keep your environment up-to-date.

Core Features & Use Cases

  • Detects install type (global vs local, git-based vs vendored) and performs the appropriate upgrade path.
  • Runs version migrations after setup to fix state and layout changes.
  • Shows a concise "What's New" summary to help users understand changes before continuing.

Quick Start

Run the /gstack-upgrade command to check for upgrades and perform the upgrade when available.

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 across different installation modes safely?

To upgrade gstack safely, the tool detects your installation type across global, local vendored, and vendored-global modes, then performs the appropriate upgrade path and applies migrations automatically.

What is the best way to automate gstack version migrations after an upgrade?

Automated gstack migrations are handled by running the upgrade command, which detects your install type, applies state and layout migrations, and ensures your environment remains up-to-date without manual intervention.

Does gstack-upgrade work with vendored-global and local vendored installs?

Yes, gstack-upgrade supports vendored-global and local vendored installations by detecting the install type and executing the correct upgrade path along with vendored-sync handling.

How do I see what changes are included in a gstack upgrade before continuing?

After performing an upgrade, gstack-upgrade presents a concise What's New summary that helps you understand version changes and state migrations before you continue working.

Can I rollback a gstack upgrade if the migrations fail?

gstack-upgrade includes team-mode safeguards and rollback-friendly upgrade logic to ensure reliable migrations, allowing you to safely manage version updates across your installations.

When do I need to run a gstack upgrade with automated migrations?

You need to run a gstack upgrade when your environment falls behind the latest version, requiring state and layout migrations to fix inconsistencies across global or vendored installations.