f6299c4d67
"Add to this project (team mode)" implied team mode replaces the global install when it actually stacks on top of it. Relabels the wizard so the relationship is explicit: - "Install gstack on this machine" (was "Install globally (on this machine)") - "Enable team mode for this repo" (was "Add to this project (team mode)") with hint: "global install + commits team-sync config to this repo so teammates auto-update" Pre-select intro note now says upfront that there are two install modes and that team mode is a superset of the machine install. Required/optional tier hints now say what each actually does (PreToolUse hook block vs CLAUDE.md nudge) instead of vague "block sessions" / "nudge teammates". No behavior changes — labels and hint text only. 77 tests still pass. |
||
|---|---|---|
| .. | ||
| src | ||
| test | ||
| .gitignore | ||
| .npmignore | ||
| PUBLISHING.md | ||
| README.md | ||
| package-lock.json | ||
| package.json | ||
| tsconfig.json | ||
| tsconfig.test.json | ||
README.md
@garrytan/gstack — installer CLI
Interactive installer for gstack, Garry Tan's Claude Code skill pack and workflow tooling.
Usage
# Zero-friction: interactive wizard
npx @garrytan/gstack
# Scripted: verb-based subcommands
npx @garrytan/gstack install --host claude,codex
npx @garrytan/gstack init --tier required
npx @garrytan/gstack upgrade
npx @garrytan/gstack uninstall --project --yes
npx @garrytan/gstack doctor
npx @garrytan/gstack status
npx @garrytan/gstack list
npx @garrytan/gstack disable /qa
npx @garrytan/gstack enable /qa
Works with npx, bunx, and pnpm dlx.
What it does
install — clones gstack into ~/.claude/skills/gstack, builds the browse/design binaries via bun, registers with your chosen AI hosts (Claude Code, Codex, Factory Droid, OpenCode, Kiro), and inserts a <!-- gstack:begin --> / <!-- gstack:end --> block into ~/.claude/CLAUDE.md documenting the available skills.
init — runs inside a git repo. Installs globally if needed, enables team mode (the SessionStart auto-update hook), runs gstack-team-init <tier> to bootstrap the repo, and stages/commits the changes. Teammates get gstack automatically on their next session.
uninstall — removes the install and walks every host's skills directory (~/.claude/skills, ~/.codex/skills, ~/.factory/skills, ~/.config/opencode/skills, ~/.kiro/skills) removing any symlink or directory whose SKILL.md points into the gstack install. Cleans the CLAUDE.md block and scrubs the PreToolUse hook from project settings.json. ~/.gstack/ (session state) is preserved.
upgrade — git fetch + hard reset to origin/main in ~/.claude/skills/gstack, then re-runs ./setup --host auto to rebuild and re-link.
doctor — checks git, bun, install state, binary freshness, skill count, and per-host registration. Exit code 1 if any check fails.
status — one-screen summary: version, install path, team mode, auto-upgrade, skill prefix mode, per-host registration, per-project disabled-skills list.
list — enumerates installed skills with descriptions parsed from each SKILL.md frontmatter.
enable <skill> / disable <skill> — toggle skills per-project via .claude/settings.local.json's disabledSkills array. Names can be qa, /qa, or gstack-qa — all normalize to the same entry.
Requirements
- Node.js 18+ (for the installer itself)
- bun 1.0+ (for building gstack binaries)
- git
- bash (Windows: Git Bash or WSL)
Philosophy
The installer is a thin wrapper around gstack's existing ./setup bash script — no logic is duplicated. This keeps the installer small, auditable, and guaranteed to stay in sync with upstream. If setup learns a new flag, the installer picks it up by exposing a new option.
Development
cd installer
npm install
npm run build # compile TS to dist/
npm start -- --help # run the built CLI
# Watch mode
npm run dev
# Smoke test locally
npm link
gstack --help
To test without publishing:
# From anywhere, use the local checkout:
npx /absolute/path/to/gstack/installer install
License
MIT — same as gstack.