gstack-upgrade

Upgrades gstack installations across git and vendored layouts with versioned migration scripts.

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill gstack-upgrade-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/gstack-upgrade
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill gstack-upgrade-sanjanb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Keeping a gstack installation current is error-prone: installs can be global git clones, local vendored copies, or both, and each version jump may require state migrations (config renames, hook registration, file structure fixes) that a plain git pull will not perform. This Skill automates the entire upgrade path safely. ## Core Features & Use Cases - Install-type detection and upgrade: Detects global-git, local-git, vendored, and vendored-global installs, then upgrades via git reset or a backup-and-replace clone flow with automatic rollback on setup failure. - Versioned migrations: Runs idempotent bash migration scripts (e.g., config key renames, stale skill removal, allowlist patches) for every version between the old and new release. - Update policy management: Supports auto-upgrade mode, escalating snooze backoff (24h/48h/1 week), and permanent opt-out of update checks. - Use Case: A user types "upgrade gstack" and the Skill detects a vendored install, backs it up, clones the latest release, runs setup, applies pending migrations, syncs the local vendored copy, and summarizes what changed in the new version. ## Quick Start Ask the agent to upgrade gstack to the latest version and show what is new.

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?

Invoke the gstack-upgrade skill or ask to "upgrade gstack". It detects your install type, runs git fetch and reset for git installs or a backup-and-reclone flow for vendored installs, executes setup, and shows a summary of what changed.

How do I enable automatic gstack upgrades?

Choose "Always keep me up to date" when the upgrade prompt appears, or run gstack-config set auto_upgrade true. Future updates then install automatically without prompting, with rollback to a backup if setup fails.

What happens if the gstack upgrade fails during setup?

For vendored installs the previous version is restored from the .bak backup directory and a warning is shown. For git installs, stashed local changes are preserved and can be recovered with git stash pop in the skill directory.

Does gstack-upgrade handle both global and local vendored copies?

Yes. After upgrading the primary install it checks for a local vendored copy. In team mode the vendored copy is removed and gitignored; otherwise it is synced from the freshly upgraded primary install.

How do I stop gstack update notifications?

Choose "Not now" to snooze with escalating backoff of 24 hours, 48 hours, then one week. Choose "Never ask again" or run gstack-config set update_check false to disable update checks permanently.

What are gstack migration scripts and when do they run?

Migrations are idempotent bash scripts in gstack-upgrade/migrations named v{VERSION}.sh. They run automatically after setup when upgrading from an older version, handling state fixes like config renames, stale skill removal, and allowlist patches.