#!/usr/bin/env bash # gstack-uninstall — remove gstack skills, state, and browse daemons # # Usage: # gstack-uninstall — interactive uninstall (prompts before removing) # gstack-uninstall --force — remove everything without prompting # gstack-uninstall --keep-state — remove skills but keep ~/.gstack/ data # # What gets REMOVED: # ~/.claude/skills/gstack — global Claude skill install (git clone or vendored) # ~/.claude/skills/{skill} — per-skill symlinks created by setup # ~/.codex/skills/gstack* — Codex skill install + per-skill symlinks # ~/.factory/skills/gstack* — Factory Droid skill install + per-skill symlinks # ~/.kiro/skills/gstack* — Kiro skill install + per-skill symlinks # ~/.cursor/skills/gstack* — Cursor skill install + per-skill symlinks # ~/.gstack/ — global state (config, analytics, sessions, projects, # repos, installation-id, browse error logs) # .claude/skills/gstack* — project-local skill install (--local installs) # .gstack/ — per-project browse state (in current git repo) # .gstack-worktrees/ — per-project test worktrees (in current git repo) # .agents/skills/gstack* — Codex/Gemini sidecar (in current git repo) # .cursor/skills/gstack* — project-local Cursor skills (in current git repo) # Running browse daemons — stopped via SIGTERM before cleanup # # What is NOT REMOVED: # ~/Library/Caches/ms-playwright/ — Playwright Chromium (shared, may be used by other tools) # ~/.gstack-dev/ — developer eval artifacts (only present in gstack contributors) # # Env overrides (for testing): # GSTACK_DIR — override auto-detected gstack root # GSTACK_STATE_DIR — override ~/.gstack state directory # # NOTE: Uses set -uo pipefail (no -e) — uninstall must never abort partway. set -uo pipefail if [ -z "${HOME:-}" ]; then echo "ERROR: \$HOME is not set" >&2 exit 1 fi GSTACK_DIR="${GSTACK_DIR:-$(cd "$(dirname "$0")/.." && pwd)}" STATE_DIR="${GSTACK_STATE_DIR:-$HOME/.gstack}" _GIT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)" # ─── Parse flags ───────────────────────────────────────────── FORCE=0 KEEP_STATE=0 while [ $# -gt 0 ]; do case "$1" in --force) FORCE=1; shift ;; --keep-state) KEEP_STATE=1; shift ;; -h|--help) sed -n '2,/^[^#]/{ /^#/s/^# \{0,1\}//p; }' "$0" exit 0 ;; *) echo "Unknown option: $1" >&2 echo "Usage: gstack-uninstall [--force] [--keep-state]" >&2 exit 1 ;; esac done # ─── Confirmation ──────────────────────────────────────────── if [ "$FORCE" -eq 0 ]; then echo "This will remove gstack from your system:" { [ -d "$HOME/.claude/skills/gstack" ] || [ -L "$HOME/.claude/skills/gstack" ]; } && echo " ~/.claude/skills/gstack (+ per-skill symlinks)" [ -d "$HOME/.codex/skills" ] && echo " ~/.codex/skills/gstack*" [ -d "$HOME/.factory/skills" ] && echo " ~/.factory/skills/gstack*" [ -d "$HOME/.kiro/skills" ] && echo " ~/.kiro/skills/gstack*" [ -d "$HOME/.cursor/skills" ] && echo " ~/.cursor/skills/gstack*" [ "$KEEP_STATE" -eq 0 ] && [ -d "$STATE_DIR" ] && echo " $STATE_DIR" if [ -n "$_GIT_ROOT" ]; then [ -d "$_GIT_ROOT/.claude/skills/gstack" ] && echo " $_GIT_ROOT/.claude/skills/gstack (project-local)" [ -d "$_GIT_ROOT/.gstack" ] && echo " $_GIT_ROOT/.gstack/ (browse state + reports)" [ -d "$_GIT_ROOT/.gstack-worktrees" ] && echo " $_GIT_ROOT/.gstack-worktrees/" [ -d "$_GIT_ROOT/.agents/skills" ] && echo " $_GIT_ROOT/.agents/skills/gstack*" [ -d "$_GIT_ROOT/.cursor/skills" ] && echo " $_GIT_ROOT/.cursor/skills/gstack*" fi # Preview running daemons if [ -n "$_GIT_ROOT" ] && [ -f "$_GIT_ROOT/.gstack/browse.json" ]; then _PREVIEW_PID="$(awk -F'[:,]' '/"pid"/ { for(i=1;i<=NF;i++) if($i ~ /"pid"/) { gsub(/[^0-9]/, "", $(i+1)); print $(i+1); exit } }' "$_GIT_ROOT/.gstack/browse.json" 2>/dev/null || true)" [ -n "$_PREVIEW_PID" ] && kill -0 "$_PREVIEW_PID" 2>/dev/null && echo " browse daemon (PID $_PREVIEW_PID) will be stopped" fi printf "\nContinue? [y/N] " read -r REPLY case "$REPLY" in y|Y|yes|YES) ;; *) echo "Aborted."; exit 0 ;; esac fi REMOVED=() # ─── Stop running browse daemons ───────────────────────────── # Browse servers write PID to {project}/.gstack/browse.json. # Stop any we can find before removing state directories. stop_browse_daemon() { local state_file="$1" if [ ! -f "$state_file" ]; then return fi local pid pid="$(awk -F'[:,]' '/"pid"/ { for(i=1;i<=NF;i++) if($i ~ /"pid"/) { gsub(/[^0-9]/, "", $(i+1)); print $(i+1); exit } }' "$state_file" 2>/dev/null || true)" if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then kill "$pid" 2>/dev/null || true # Wait up to 2s for graceful shutdown local waited=0 while [ "$waited" -lt 4 ] && kill -0 "$pid" 2>/dev/null; do sleep 0.5 waited=$(( waited + 1 )) done if kill -0 "$pid" 2>/dev/null; then kill -9 "$pid" 2>/dev/null || true fi REMOVED+=("browse daemon (PID $pid)") fi } # Stop daemon in current project if [ -n "$_GIT_ROOT" ] && [ -f "$_GIT_ROOT/.gstack/browse.json" ]; then stop_browse_daemon "$_GIT_ROOT/.gstack/browse.json" fi # Stop daemons tracked in global projects directory if [ -d "$STATE_DIR/projects" ]; then while IFS= read -r _BJ; do stop_browse_daemon "$_BJ" done < <(find "$STATE_DIR/projects" -name browse.json -path '*/.gstack/*' 2>/dev/null || true) fi # ─── Remove global Claude skills ──────────────────────────── CLAUDE_SKILLS="$HOME/.claude/skills" # Skill-name inventory (#2563 gate a): every name setup could have installed — # each source skill's directory name, its frontmatter name, their gstack- # prefixed variants, and the alias dirs. Built BEFORE the install root is # removed. A real directory in ~/.claude/skills is only deletable when its # name is in this inventory AND its SKILL.md carries the generated banner. # The seed names below are the alias dirs setup's _install_alias_skill_md # creates (setup: link_claude_root_skill_alias + the connect-chrome call # sites) — keep in sync with setup if an alias is added or renamed there. _INVENTORY=" _gstack-command connect-chrome gstack-connect-chrome " if [ -d "$GSTACK_DIR" ]; then for _SRC in "$GSTACK_DIR"/*/; do [ -f "$_SRC/SKILL.md" ] || continue _SRC_NAME="$(basename "$_SRC")" _FM_NAME=$(grep -m1 '^name:' "$_SRC/SKILL.md" 2>/dev/null | sed 's/^name:[[:space:]]*//' | tr -d '[:space:]' || true) for _N in "$_SRC_NAME" "$_FM_NAME"; do [ -n "$_N" ] || continue case "$_INVENTORY" in *" $_N "*) ;; *) _INVENTORY="$_INVENTORY$_N gstack-$_N " ;; esac done done fi _in_skill_inventory() { case "$_INVENTORY" in *" $1 "*) return 0 ;; *) return 1 ;; esac; } _SKIPPED_DIRS=() if [ -d "$CLAUDE_SKILLS/gstack" ] || [ -L "$CLAUDE_SKILLS/gstack" ]; then # Remove per-skill entries created by setup. Three install shapes exist: # 1. symlink entry (oldest installs) # 2. real dir + SYMLINKED SKILL.md (standard Unix install) # 3. real dir + REAL-FILE SKILL.md (Windows copy install, #2563) # Shape 3 was skipped entirely — gstack-uninstall exited 0 and reported # success while leaving ~52 gstack-* directories behind on Windows. for _ENTRY in "$CLAUDE_SKILLS"/*; do _NAME="$(basename "$_ENTRY")" [ "$_NAME" = "gstack" ] && continue if [ -L "$_ENTRY" ]; then _TARGET="$(readlink "$_ENTRY" 2>/dev/null || true)" case "$_TARGET" in gstack/*|*/gstack/*) rm -f "$_ENTRY"; REMOVED+=("claude/$_NAME") ;; esac elif [ -d "$_ENTRY" ] && { [ -f "$_ENTRY/SKILL.md" ] || [ -L "$_ENTRY/SKILL.md" ]; }; then if [ -L "$_ENTRY/SKILL.md" ]; then # Shape 2: provenance readable from the symlink target itself. # Gate 1: the name must be in gstack's skill inventory (parity with # shape 3). Gate 2: the target must contain "gstack" as an ANCHORED # path segment (gstack/*|*/gstack/*, same pattern as shape 1) — a # bare *gstack* substring match would wipe a user's own skill whose # SKILL.md merely lives under e.g. ~/tools/gstack-fork/. _TARGET="$(readlink "$_ENTRY/SKILL.md" 2>/dev/null || true)" if _in_skill_inventory "$_NAME"; then case "$_TARGET" in gstack/*|*/gstack/*) rm -rf "$_ENTRY"; REMOVED+=("claude/$_NAME") ;; *) _SKIPPED_DIRS+=("$_ENTRY") ;; esac else _SKIPPED_DIRS+=("$_ENTRY") fi elif _in_skill_inventory "$_NAME" && grep -q '