From fa02cd22798517777bf75d0364d68a6d3d1942fc Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Wed, 15 Apr 2026 14:59:09 -0400 Subject: [PATCH] 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 --- get-shit-done/references/workstream-flag.md | 24 ++++++++++++--------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/get-shit-done/references/workstream-flag.md b/get-shit-done/references/workstream-flag.md index 10d908b2b..9d6145786 100644 --- a/get-shit-done/references/workstream-flag.md +++ b/get-shit-done/references/workstream-flag.md @@ -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 -node gsd-tools.cjs workstream list -node gsd-tools.cjs workstream status -node gsd-tools.cjs workstream complete +node "$GSD_TOOLS" workstream create +node "$GSD_TOOLS" workstream list +node "$GSD_TOOLS" workstream status +node "$GSD_TOOLS" workstream complete ```