Skip to content

chore(preview): add a Local Studio (dev:local) worktree preview config #1796

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
dawsontoth wants to merge 1 commit into
base: stage
Choose a base branch
from
Draft

chore(preview): add a Local Studio (dev:local) worktree preview config #1796

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .claude/launch.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,12 @@
"runtimeExecutable": "bash",
"runtimeArgs": [".claude/preview-worktree.sh"],
"port": 5173
},
{
"name": "studio local (worktree)",
"runtimeExecutable": "bash",
"runtimeArgs": [".claude/preview-worktree.sh", "dev:local"],
"port": 5173
}
]
}
21 changes: 12 additions & 9 deletions .claude/preview-worktree.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
#!/usr/bin/env bash
# Launch helper for the "studio (worktree)" preview config.
# Launch helper for the "studio (worktree)" and "studio local (worktree)" preview configs.
#
# Problem: `preview_start` reads .claude/launch.json from the *main* checkout (the session
# cwd) and takes no arguments, so it always serves the main checkout. When you're working in
# a linked worktree you want the preview to serve THAT worktree's code — and on the same port
# (5173) so the backend's auth/origin carries over.
#
# Solution: this script reads the target directory from `.claude/preview-cwd` (a path relative
# to the repo root, gitignored — write it before starting the server), falls back to the main
# checkout when that file is absent, and starts the dev server there. To keep a fresh worktree
# zero-setup it symlinks node_modules and .env.local from the main checkout when missing.
# to the repo root, gitignored — write it before starting the server), falls back to the
# checkout it was launched from when that file is absent, and starts the dev server there. To
# keep a fresh worktree zero-setup it symlinks node_modules and .env.local from the main
# checkout when missing.
#
# Usage: echo .claude/worktrees/<name> > .claude/preview-cwd # then preview_start "studio (worktree)"
# Usage: echo .claude/worktrees/<name> > .claude/preview-cwd # then preview_start "studio (worktree)",
# or "studio local (worktree)" for Local Studio mode (needs Harper at VITE_LOCAL_STUDIO_DEV_URL).
set -e
dev_script="${1:-dev}"

root="${CLAUDE_PROJECT_DIR:-$PWD}"
cd "$root"
Expand All @@ -24,8 +27,8 @@ cd "$root"
main_checkout="$(cd "$(dirname "$(git rev-parse --git-common-dir)")" && pwd)"

# Read the target worktree from .claude/preview-cwd (repo-relative). `read` trims surrounding
# whitespace and tolerates a missing trailing newline; fall back to the main checkout when the
# file is absent or empty.
# whitespace and tolerates a missing trailing newline; fall back to $root when the file is absent
# or empty.
target=""
if [ -f .claude/preview-cwd ]; then
read -r target < .claude/preview-cwd || :
Expand Down Expand Up @@ -80,8 +83,8 @@ if [ -z "$current_major" ] || [ "$current_major" -lt 22 ]; then
fi
fi

echo "[preview] Serving $(pwd) on port 5173" >&2
echo "[preview] Serving $(pwd) on port 5173 via 'pnpm run $dev_script'" >&2
# node_modules is symlinked from the main checkout; skip pnpm's pre-run deps check so it can't
# try to reinstall/purge it (the workspace state won't match, and a purge would mutate the
# shared checkout). We just want to run the dev script against the already-installed modules.
exec pnpm --config.verify-deps-before-run=false run dev
exec pnpm --config.verify-deps-before-run=false run "$dev_script"

@gemini-code-assist gemini-code-assist Bot Oct 11, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

To make the preview script more flexible, consider forwarding any additional arguments passed to the script (such as --force or other Vite flags) to the underlying pnpm run command. This can be achieved cleanly by appending "${@:2}" to the pnpm run command, which safely expands to all arguments starting from the second one (or nothing if none are provided).

Suggested change
exec pnpm --config.verify-deps-before-run=false run "$dev_script"
exec pnpm --config.verify-deps-before-run=false run "$dev_script" "${@:2}"

Loading