mirror of https://github.com/garrytan/gstack.git
714e968d69
Adds installer/ — a TypeScript CLI that wraps the existing ./setup bash script behind a zero-friction `npx` entry point. Replaces the paste-prompt install flow with an interactive wizard while preserving ./setup as the source of truth for host registration and symlinks. Commands: install | init | uninstall (--project) | upgrade | doctor status | list | enable <skill> | disable <skill> No-args launches a @clack/prompts wizard that auto-detects git repos + installed hosts (claude, codex, factory, opencode, kiro), collects multi-select host + prefix + CLAUDE.md choices, and routes to install or team-mode init. The CLI: - clones garrytan/gstack into ~/.claude/skills/gstack - shells out to ./setup once per selected host (or --host auto) - for init, runs ./setup --team + bin/gstack-team-init <required|optional>, stages .claude/ + CLAUDE.md - inserts/updates a fenced <!-- gstack:begin --> block in CLAUDE.md listing every discovered skill - uninstall walks ~/.claude, ~/.codex, ~/.factory, ~/.config/opencode, ~/.kiro skills dirs and removes symlinks/dirs pointing into the gstack install (canonicalized with fs.realpathSync to handle macOS /var vs /private/var), then removes the CLAUDE.md block and scrubs gstack PreToolUse hooks from project .claude/settings.json - preserves ~/.gstack/ session state across uninstalls Testing: - 77 tests, bun:test runner, 3s runtime - Unit: claude-md (11), skills (12), project-config (11), cleanup (12 + a /var realpath regression test), paths (9) - Integration: spawns dist/cli.js against fake HOME fixtures — verifies exit codes, enable/disable round-trip + name normalization, uninstall scrubs settings.json preserving non-gstack hooks and top-level keys, EPIPE handling under `gstack list | head`, wizard intro without TTY End-to-end dry-run completed via `npm link` and `npm pack` against a real clone + real build (clone -> browse binary -> Playwright Chromium -> 40 skills linked -> CLAUDE.md written -> doctor green -> uninstall leaves 0 zombies). Live demo published under @jkresabal/gstack for testing: npx @jkresabal/gstack Upstream publish (after this PR): cd installer && npm publish --access public Philosophy: thin wrapper. ~2.3K LOC, 16KB packed, two runtime deps (@clack/prompts + picocolors), Node 18+. No logic duplicated from ./setup. If ./setup learns a new flag, the CLI surfaces it with one line. |
||
|---|---|---|
| .. | ||
| integration | ||
| unit | ||
| helpers.ts | ||