#!/usr/bin/env bash # Set up gstack for local development — test skills from within this repo. # # Creates .claude/skills/gstack → (symlink to repo root) so Claude Code # discovers skills from your working tree. Changes take effect immediately. # # Also copies .env from the main worktree if this is a Conductor workspace # or git worktree (so API keys carry over automatically). # # Usage: bin/dev-setup # set up # bin/dev-teardown # clean up set -e REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)" # 1. Copy .env from main worktree (if we're a worktree and don't have one) if [ ! -f "$REPO_ROOT/.env" ]; then MAIN_WORKTREE="$(git -C "$REPO_ROOT" worktree list --porcelain 2>/dev/null | head -1 | sed 's/^worktree //')" if [ -n "$MAIN_WORKTREE" ] && [ "$MAIN_WORKTREE" != "$REPO_ROOT" ] && [ -f "$MAIN_WORKTREE/.env" ]; then cp "$MAIN_WORKTREE/.env" "$REPO_ROOT/.env" echo "Copied .env from main worktree ($MAIN_WORKTREE)" fi fi # 2. Install dependencies if [ ! -d "$REPO_ROOT/node_modules" ]; then echo "Installing dependencies..." (cd "$REPO_ROOT" && bun install) fi # 3. Create .claude/skills/ inside the repo mkdir -p "$REPO_ROOT/.claude/skills" # 4. Symlink .claude/skills/gstack → repo root # This makes setup think it's inside a real .claude/skills/ directory GSTACK_LINK="$REPO_ROOT/.claude/skills/gstack" if [ -L "$GSTACK_LINK" ]; then echo "Updating existing symlink..." rm "$GSTACK_LINK" elif [ -d "$GSTACK_LINK" ]; then echo "Error: .claude/skills/gstack is a real directory, not a symlink." >&2 echo "Remove it manually if you want to use dev mode." >&2 exit 1 fi ln -s "$REPO_ROOT" "$GSTACK_LINK" # 5. Create .agents/skills/gstack → repo root (for Codex/Gemini/Cursor) mkdir -p "$REPO_ROOT/.agents/skills" AGENTS_LINK="$REPO_ROOT/.agents/skills/gstack" if [ -L "$AGENTS_LINK" ]; then rm "$AGENTS_LINK" elif [ -d "$AGENTS_LINK" ]; then echo "Warning: .agents/skills/gstack is a real directory, skipping." >&2 fi if [ ! -e "$AGENTS_LINK" ]; then ln -s "$REPO_ROOT" "$AGENTS_LINK" fi # 6. Run setup via the symlink so it detects .claude/skills/ as its parent. # # Workspace/dev setup MUST be non-interactive: Conductor runs this under a # forwarded pty, so any `read` in setup (skill-prefix prompt, plan-tune hook # consent) would hang the workspace forever. Detaching stdin makes every setup # prompt take its smart non-interactive default (flat skill names, etc.). # # `--plan-tune-hooks=prompt` is load-bearing, not redundant: stdin alone only # suppresses the *prompt* branch. A saved `plan_tune_hooks: yes` or an exported # GSTACK_PLAN_TUNE_HOOKS=yes would still resolve to "install" and rewrite the # user's global ~/.claude/settings.json to point at THIS ephemeral worktree — # which breaks once the workspace is deleted. The flag has highest precedence, # so it pins resolution to "prompt", and closed stdin then makes prompt-mode a # no-op skip (no install, no decline marker). A dev workspace must never mutate # global settings.json. To install the hooks, run `./setup --plan-tune-hooks` # directly (outside dev-setup). Saved prefix/other config preferences still apply. # # GSTACK_SKIP_GBRAIN_REGEN=1 is passed INLINE (not exported) so it scopes to # exactly this nested setup call and can't leak into any other setup path. It # tells setup NOT to regenerate the gbrain :user variant into the tracked # worktree (that would dirty checked-in source). We render it into an untracked # per-workspace dir below instead. GSTACK_SKIP_GBRAIN_REGEN=1 "$GSTACK_LINK/setup" --plan-tune-hooks=prompt /dev/null; then echo "" echo "gbrain detected — rendering brain-aware skills into .claude/gstack-rendered (workspace-only, untracked)..." rm -rf "$RENDER_DIR" if ( cd "$REPO_ROOT" && bun run gen:skill-docs:user --host claude --out-dir "$RENDER_DIR" >/dev/null 2>&1 ); then # Repoint each project-local SKILL.md symlink whose worktree target has a # rendered counterpart. The skill DIRECTORY name (basename of the symlink # target's dir) maps to RENDER_DIR//SKILL.md, which is robust to # frontmatter renames and the gstack- prefix on the link name. repointed=0 for skill_link in "$REPO_ROOT"/.claude/skills/*/SKILL.md; do [ -L "$skill_link" ] || continue target="$(readlink "$skill_link")" skilldir="$(basename "$(dirname "$target")")" rendered="$RENDER_DIR/$skilldir/SKILL.md" if [ -f "$rendered" ]; then ln -snf "$rendered" "$skill_link"; repointed=$((repointed + 1)); fi done echo " $repointed workspace skills now serve brain-aware blocks (worktree stays canonical)." else echo " warning: brain-aware render failed — workspace uses canonical skills." fi fi echo "" echo "Dev mode active. Skills resolve from this working tree." echo " .claude/skills/gstack → $REPO_ROOT" echo " .agents/skills/gstack → $REPO_ROOT" echo "Edit any SKILL.md and test immediately — no copy/deploy needed." echo "" echo "To make brain-aware blocks live across your OTHER projects too, run:" echo " gstack-config gbrain-refresh" echo "" echo "To tear down: bin/dev-teardown"