docs(references): use \$GSD_TOOLS variable in workstream-flag.md CLI examples (#2245) (#2255)

Replace bare `node gsd-tools.cjs` invocations with `node "\$GSD_TOOLS"` throughout
the CLI Usage section, and add a comment explaining that \$GSD_TOOLS resolves to the
full installed bin path (global or local). Bare relative paths only work from the
install directory and silently fail when run from a project root.

Closes #2245

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Tom Boucher
2026-04-15 14:59:09 -04:00
committed by GitHub
parent 2f28c99db4
commit fa02cd2279

View File

@@ -93,19 +93,23 @@ This ensures workstream scope chains automatically through the workflow:
## CLI Usage
```bash
# GSD_TOOLS resolves to the installed bin path, e.g.:
# $HOME/.claude/get-shit-done/bin/gsd-tools.cjs (global install)
# .claude/get-shit-done/bin/gsd-tools.cjs (local install)
# All gsd-tools commands accept --ws
node gsd-tools.cjs state json --ws feature-a
node gsd-tools.cjs find-phase 3 --ws feature-b
node "$GSD_TOOLS" state json --ws feature-a
node "$GSD_TOOLS" find-phase 3 --ws feature-b
# Session-local switching without --ws on every command
GSD_SESSION_KEY=my-terminal-a node gsd-tools.cjs workstream set feature-a
GSD_SESSION_KEY=my-terminal-a node gsd-tools.cjs state json
GSD_SESSION_KEY=my-terminal-b node gsd-tools.cjs workstream set feature-b
GSD_SESSION_KEY=my-terminal-b node gsd-tools.cjs state json
GSD_SESSION_KEY=my-terminal-a node "$GSD_TOOLS" workstream set feature-a
GSD_SESSION_KEY=my-terminal-a node "$GSD_TOOLS" state json
GSD_SESSION_KEY=my-terminal-b node "$GSD_TOOLS" workstream set feature-b
GSD_SESSION_KEY=my-terminal-b node "$GSD_TOOLS" state json
# Workstream CRUD
node gsd-tools.cjs workstream create <name>
node gsd-tools.cjs workstream list
node gsd-tools.cjs workstream status <name>
node gsd-tools.cjs workstream complete <name>
node "$GSD_TOOLS" workstream create <name>
node "$GSD_TOOLS" workstream list
node "$GSD_TOOLS" workstream status <name>
node "$GSD_TOOLS" workstream complete <name>
```