RomanNum3ral
/
gstack
mirror of https://github.com/garrytan/gstack.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

fix(setup-gbrain): register gbrain MCP via direct bun on Windows to stop console-window popups 

On Windows, /setup-gbrain registers the gbrain MCP as `$HOME/.bun/bin/gbrain
serve`. That `gbrain` is the bun-generated binstub (gbrain.exe), which
re-launches the bun runtime in a NEW console, so Claude Code spawns a visible
terminal window/tab for the gbrain MCP on every session.

Register `bun <entry> serve` directly on Windows instead. bun then attaches to
Claude Code's headless pseudo-console the same way node-based MCP servers do, so
no window appears. POSIX behavior is unchanged; falls back to the binstub if the
entry script isn't found.

Template only; SKILL.md regenerated in the next commit.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
pmaxhogan 2026-06-14 15:19:48 -05:00
parent c7ae63201a
commit b1e23db5b4
1 changed files with 22 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
setup-gbrain/SKILL.md.tmpl
View File

@ -543,7 +543,28 @@ GBRAIN_BIN=$(command -v gbrain)
[ -z "$GBRAIN_BIN" ] && GBRAIN_BIN="$HOME/.bun/bin/gbrain"
claude mcp remove gbrain -s user 2>/dev/null || true
claude mcp remove gbrain 2>/dev/null || true
claude mcp add --scope user gbrain -- "$GBRAIN_BIN" serve
# Windows: the bun-generated `gbrain` binstub (gbrain.exe) re-launches the bun
# runtime in a NEW console, so registering it as the MCP command pops a visible
# terminal window/tab on every Claude Code session. Registering `bun <entry>
# serve` directly lets bun attach to Claude Code's headless pseudo-console
# (the same reason node-based MCP servers don't pop a window). The entry is the
# gbrain package's `bin` (src/cli.ts), reachable through the bun global
# node_modules for both `bun install -g` and `bun link`ed clones. POSIX is
# unaffected; fall back to the binstub if the entry isn't found.
case "$(uname -s)" in
MINGW*|MSYS*|CYGWIN*)
GBRAIN_ENTRY="$HOME/.bun/install/global/node_modules/gbrain/src/cli.ts"
if [ -f "$GBRAIN_ENTRY" ] && [ -f "$HOME/.bun/bin/bun.exe" ]; then
claude mcp add --scope user gbrain -- "$HOME/.bun/bin/bun.exe" "$GBRAIN_ENTRY" serve
else
claude mcp add --scope user gbrain -- "$GBRAIN_BIN" serve
fi
;;
*)
claude mcp add --scope user gbrain -- "$GBRAIN_BIN" serve
;;
esac
claude mcp list | grep gbrain # verify: should show "✓ Connected"
```