gstack-upgrade

Upgrades gstack installations by detecting install type and syncing vendored copies.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/TarunTeja44/portfolio --skill gstack-upgrade-tarunteja44
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-upgrade
Source: https://github.com/TarunTeja44/portfolio/tree/main/.agents/skills/gstack-upgrade
Command: npx skills add https://github.com/TarunTeja44/portfolio --skill gstack-upgrade-tarunteja44

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping gstack up to date is error-prone when installs exist in multiple locations (global git clone, local git clone, or vendored copies). This Skill automates version detection, upgrade execution, backup/rollback, and changelog summarization so users stay current without manual git operations. ## Core Features & Use Cases - Install Type Detection: Automatically identifies whether gstack is installed as a global git clone, local git clone, or vendored directory, and applies the correct upgrade strategy. - Safe Upgrade with Rollback: Backs up the previous version before upgrading and restores it automatically if the setup step fails. - Vendored Copy Sync: Detects and updates stale local vendored copies so global and project-level installs stay in sync. - Update Preferences: Supports auto-upgrade mode, snoozing reminders with escalating backoff (24h, 48h, 1 week), and disabling update checks entirely. - Use Case: A user runs /gstack-upgrade and the Skill detects a vendored install, clones the latest release, runs setup, syncs the local copy, and shows a summarized "What's New" changelog. ## Quick Start Ask the assistant to upgrade gstack to the latest version and show what changed.

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?

Run the /gstack-upgrade command, which forces a fresh update check and upgrades your install. It detects whether gstack is a git clone or vendored copy, applies the correct upgrade method, and shows a summary of what changed.

How does gstack detect global vs vendored installs?

It checks for a .git directory in ~/.claude/skills/gstack or .claude/skills/gstack to identify git installs, and falls back to treating plain directories as vendored installs. Git installs upgrade via git fetch and reset, while vendored installs are replaced with a fresh clone.

What happens if the gstack upgrade fails during setup?

The previous version is restored from the .bak backup directory created before the upgrade. You are warned that the upgrade failed and can rerun /gstack-upgrade manually to retry.

Can I enable automatic gstack upgrades?

Yes, set auto_upgrade to true using the gstack-config command or the GSTACK_AUTO_UPGRADE environment variable. Future updates then install automatically without prompting, with rollback if setup fails.

How do I snooze or disable gstack update reminders?

Choosing "Not now" snoozes reminders with escalating backoff of 24 hours, 48 hours, then one week. Choosing "Never ask again" sets update_check to false via gstack-config, which you can re-enable later.