[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-vercel-internal-dev-workbench":3,"mdc-tl8kxm-key":34,"related-repo-vercel-internal-dev-workbench":2237,"related-org-vercel-internal-dev-workbench":2287},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":32,"mdContent":33},"internal-dev-workbench","set up isolated development workbenches","Spin up a portless + tmux dev session for the Workflow SDK that gives each git worktree isolated `\u003Cbranch>.\u003Cname>.localhost` URLs for the Next.js workbench and the observability UI, plus a Claude statusline that surfaces those URLs. Use only when the user asks for a \"portless dev session\", a \"tmux dev layout for workflow\", \"worktree-isolated dev URLs\", or wants to wire workflow dev URLs into the Claude statusline. Do not activate for the generic \"start the dev server\" \u002F \"run pnpm dev\" task.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"vercel","Vercel","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fvercel.png",[12,16,17,20],{"name":13,"slug":14,"type":15},"Observability","observability","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Local Development","local-development",{"name":21,"slug":22,"type":15},"Engineering","engineering",2228,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fworkflow","2026-05-05T05:21:00.024468",null,307,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":31},[],"Workflow SDK: Build durable, reliable, and observable apps and AI Agents in TypeScript","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fworkflow\u002Ftree\u002FHEAD\u002Fskills\u002Finternal-dev-workbench","---\nname: internal-dev-workbench\ndescription: Spin up a portless + tmux dev session for the Workflow SDK that gives each git worktree isolated `\u003Cbranch>.\u003Cname>.localhost` URLs for the Next.js workbench and the observability UI, plus a Claude statusline that surfaces those URLs. Use only when the user asks for a \"portless dev session\", a \"tmux dev layout for workflow\", \"worktree-isolated dev URLs\", or wants to wire workflow dev URLs into the Claude statusline. Do not activate for the generic \"start the dev server\" \u002F \"run pnpm dev\" task.\nmetadata:\n  author: Pranay Prakash\n  version: '0.1'\n---\n\n# internal-dev-workbench\n\nBootstraps an opinionated 3-pane tmux session for end-to-end Workflow SDK development. Each pane is launched through [portless](https:\u002F\u002Fgithub.com\u002Faleclarson\u002Fportless) so URLs are stable and worktree-scoped (e.g. `https:\u002F\u002F\u003Cbranch>.turbopack.localhost`), letting multiple worktrees run concurrently without port conflicts. A companion statusline script surfaces the active URLs in Claude Code's prompt.\n\nThis is **opt-in contributor tooling**. The repo's standard dev path (`pnpm dev` from a workbench, no portless) is unaffected.\n\n## Prerequisites\n\n- `tmux` installed\n- `portless` installed globally (`npm i -g portless` or via Homebrew). Verify with `portless --version`.\n- Repo bootstrapped: `pnpm install && pnpm build`. The first run on a fresh worktree must complete both before any dev server can start (the workbench apps depend on built workspace packages — without `pnpm build` you get `MODULE_NOT_FOUND` for `workflow`).\n- `WORKFLOW_PUBLIC_MANIFEST=1` is required on the dev server when running e2e tests against it (otherwise `\u002F.well-known\u002Fworkflow\u002Fv1\u002Fmanifest.json` is gated).\n\n## Layout\n\n`main-vertical` — the dev server takes the left column; the right column stacks the observability UI on top of a scratchpad shell:\n\n```\n+----------------------+--------------------------+\n|                      |  PANE_OBS: workflow web  |\n|                      |  (observability UI       |\n|  PANE_DEV: turbopack |   scoped to the          |\n|  (Next.js dev)       |   workbench app)         |\n|                      +--------------------------+\n|                      |  PANE_SH: zsh scratchpad |\n|                      |  (repo root — for build, |\n|                      |   tests, e2e, git, etc.) |\n+----------------------+--------------------------+\n```\n\n## Setup\n\nThe session name **must** match the worktree's portless prefix — the basename of the current branch — so the statusline (and any other tooling that derives the prefix from the branch) can locate it. Always run `tmux ls` first to confirm there's no pre-existing session with that name; never kill an existing one.\n\nPane indices in tmux depend on `pane-base-index` (0 by default, 1 with the common dotfile override). To stay correct under either, capture each pane's ID at split time with `-P -F '#{pane_id}'` and use those IDs as targets:\n\n```bash\nREPO=\u002Fpath\u002Fto\u002Fworkflow--\u003Cworktree-suffix>\n# Session name = basename of the branch (matches portless's subdomain prefix\n# and the statusline's `tmux attach -t \u003Cprefix>` indicator). For branch\n# `pgp\u002Ffoo-bar` this resolves to `foo-bar`.\nSESSION=$(git -C \"$REPO\" rev-parse --abbrev-ref HEAD)\nSESSION=\"${SESSION##*\u002F}\"\n\n# Create the session and capture the initial pane ID\nPANE_DEV=$(tmux new-session -d -s \"$SESSION\" -c \"$REPO\" -P -F '#{pane_id}')\nPANE_OBS=$(tmux split-window -h -t \"$PANE_DEV\" -c \"$REPO\" -P -F '#{pane_id}')\nPANE_SH=$(tmux split-window -v -t \"$PANE_OBS\" -c \"$REPO\" -P -F '#{pane_id}')\ntmux select-layout -t \"$SESSION\" main-vertical\n\n# Pane DEV (left): Next.js turbopack workbench, with manifest exposed for e2e\ntmux send-keys -t \"$PANE_DEV\" \\\n  'cd workbench\u002Fnextjs-turbopack && WORKFLOW_PUBLIC_MANIFEST=1 portless run --name turbopack pnpm dev' C-m\n\n# Pane OBS (top-right): observability UI scoped to the workbench app\ntmux send-keys -t \"$PANE_OBS\" \\\n  'cd workbench\u002Fnextjs-turbopack && portless run --name workflow-obs sh -c \"pnpm workflow web --webPort \\$PORT --noBrowser\"' C-m\n\n# Pane SH (bottom-right): scratchpad at repo root\ntmux send-keys -t \"$PANE_SH\" 'echo \"scratchpad: $(pwd)\"' C-m\n\ntmux attach -t \"$SESSION\"\n```\n\nOnce both servers are ready, `portless list` shows the routes. With `portless run`, each linked worktree gets a unique branch-prefixed subdomain (e.g. `stepflow-test.turbopack.localhost`), so multiple worktrees coexist without changing config.\n\n## Why each piece\n\n- **`portless run --name \u003Cname>`** (instead of `portless \u003Cname> \u003Ccmd>`): `run` auto-detects git worktrees and prepends the sanitized branch name as a subdomain. The `--name` flag overrides the inferred base name while preserving the worktree prefix.\n- **`pnpm workflow web --webPort $PORT --noBrowser`** (instead of `pnpm dev` in `packages\u002Fweb`): the bundled CLI starts the observability UI configured against the **current workbench app**, hydrating it with that project's local World data. Running `packages\u002Fweb`'s own `dev` script gives you the UI but pointed at nothing.\n- **`sh -c '... --webPort $PORT'`**: portless's auto `--port` injection only triggers for known frameworks it can detect on the command line. When the command is a CLI wrapper (`pnpm workflow web`), wrap in `sh -c` and read `$PORT` (which portless always sets) explicitly.\n- **`WORKFLOW_PUBLIC_MANIFEST=1`** on the dev pane: required for e2e tests to fetch the workflow registry from the dev server.\n- **`-P -F '#{pane_id}'`**: makes the snippet correct regardless of the user's `pane-base-index` setting (defaults vary across configs).\n\n## Claude statusline integration\n\nThe skill ships a statusline helper at `skills\u002Finternal-dev-workbench\u002Fstatusline.sh` that derives the worktree prefix from the current branch and emits a compact line:\n\n```\n dev  ·   obs  ·   tmux attach -t \u003Cworktree-prefix>\n```\n\nThe dev \u002F obs labels (Nerd Font rocket \u002F graph glyphs) are OSC 8 hyperlinks — clickable in iTerm2, Kitty, WezTerm, Terminal.app, Ghostty — styled bold + underlined + bright cyan so they read unambiguously as links. The tmux fragment (Nerd Font copy glyph) is bold bright green, signaling \"copy this\" rather than \"click this\". It's shown only when a session named exactly the worktree prefix exists, and it's printed as a full ready-to-paste `tmux attach -t \u003Cprefix>` invocation. The font must include Nerd Font glyphs for the icons to render correctly; without them you'll see substitution boxes but the layout still works. Each piece is independent — if portless has no `\u003Cprefix>.turbopack.localhost` route, the dev fragment is omitted, and so on. With nothing to show, the script prints nothing and the statusline stays silent.\n\nWire it into `~\u002F.claude\u002Fsettings.json` so it works across all sessions and worktrees. **Point the path at your primary checkout, not at a worktree** — worktrees get deleted, so any path like `~\u002Fgithub\u002Fvercel\u002Fworkflow--\u003Cbranch>\u002F...` will break the day you remove that worktree:\n\n```json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"$HOME\u002Fgithub\u002Fvercel\u002Fworkflow\u002Fskills\u002Finternal-dev-workbench\u002Fstatusline.sh\"\n  }\n}\n```\n\nAdjust the prefix if your main checkout lives elsewhere. The script itself is worktree-aware: it reads Claude's `workspace.current_dir` from stdin to derive the current branch, so the *same script invocation* from `~\u002Fgithub\u002Fvercel\u002Fworkflow\u002F...` correctly surfaces routes for whichever worktree the Claude session is running in.\n\nOutput rules:\n- Nothing to show (no matching portless route, no matching tmux session) → empty output.\n- Each piece appears independently — start a server but no tmux session and you'll see just the dev\u002Fobs fragments; the reverse shows just the tmux fragment.\n- No git context but routes exist → falls back to the first matching `turbopack`\u002F`workflow-obs` route, no tmux indicator.\n\nIf you already use a statusline and want to append the internal-dev-workbench info, run the helper and concatenate in your existing wrapper script instead of replacing `command` outright.\n\n## Restarting after editing workflow files\n\nThe workflow manifest is built at dev-server startup. New workflows or steps added to `workbench\u002Fexample\u002Fworkflows\u002F*.ts` (and their symlinks in other workbenches) **do not appear at runtime** — even with HMR — until the dev server restarts.\n\n```bash\ntmux send-keys -t \"$PANE_DEV\" C-c\n# Wait for the prompt to return\ntmux send-keys -t \"$PANE_DEV\" \\\n  'cd workbench\u002Fnextjs-turbopack && WORKFLOW_PUBLIC_MANIFEST=1 portless run --name turbopack pnpm dev' C-m\n```\n\nVerify the new workflow is registered (use the portless-assigned local port from `portless list`, or the `.localhost` URL with the trusted CA):\n\n```bash\n\u002Fusr\u002Fbin\u002Fcurl -s \"$(portless get turbopack)\u002F.well-known\u002Fworkflow\u002Fv1\u002Fmanifest.json\" \\\n  | grep -o '\u003Cyour-new-workflow>'\n```\n\n`NODE_EXTRA_CA_CERTS=\u002Ftmp\u002Fportless\u002Fca.pem` is needed for Node clients hitting the HTTPS URL outside of portless-managed children. Browsers are fine after `portless trust`.\n\n## Running e2e tests against this session\n\nFrom the scratchpad pane. Use the portless-assigned local port to bypass TLS for the test runner:\n\n```bash\nPORT=$(portless list | awk '\u002Fturbopack\u002F {n=split($3,a,\":\"); print a[n]; exit}')\nDEPLOYMENT_URL=\"http:\u002F\u002Flocalhost:$PORT\" APP_NAME=\"nextjs-turbopack\" \\\n  pnpm vitest run packages\u002Fcore\u002Fe2e\u002Fe2e.test.ts -t \"\u003Ctest name>\"\n```\n\nOr use the portless URL with the CA trust:\n\n```bash\nNODE_EXTRA_CA_CERTS=\u002Ftmp\u002Fportless\u002Fca.pem \\\n  DEPLOYMENT_URL=\"$(portless get turbopack)\" APP_NAME=\"nextjs-turbopack\" \\\n  pnpm vitest run packages\u002Fcore\u002Fe2e\u002Fe2e.test.ts -t \"\u003Ctest name>\"\n```\n\n## Teardown\n\n```bash\ntmux kill-session -t \"$SESSION\"\n```\n\nPortless removes routes when each child process exits (Ctrl+C the panes first if you want a clean `portless list`). The proxy itself keeps running for other sessions; stop it explicitly with `portless proxy stop` if needed.\n\n## Troubleshooting\n\n- **`MODULE_NOT_FOUND: 'workflow'`** in the dev pane — workspace packages haven't been built. Run `pnpm build` from the repo root, then restart the pane.\n- **Observability UI shows no runs** — verify the obs pane was started from inside `workbench\u002Fnextjs-turbopack` (or whichever workbench you want to inspect). The CLI reads the local World from the **current working directory**.\n- **react-router on `:5173` instead of the portless port** — happens when the obs pane uses `pnpm dev` from `packages\u002Fweb`. Switch to the `pnpm workflow web --webPort $PORT` form above.\n- **Source-map warning on startup** (`failed to read input source map ... packages\u002Fserde\u002Fdist\u002Findex.js.map`) — benign; doesn't block dev.\n- **Stale workflow registration** after editing `99_e2e.ts` — restart the dev pane; HMR doesn't rebuild the manifest.\n- **Statusline shows nothing** — confirm `portless list` has at least one matching route, the path in `settings.json` is absolute, and the script is executable (`chmod +x`).\n",{"data":35,"body":39},{"name":4,"description":6,"metadata":36},{"author":37,"version":38},"Pranay Prakash","0.1",{"type":40,"children":41},"root",[42,49,75,96,103,201,207,218,230,236,256,277,996,1025,1031,1201,1207,1220,1229,1250,1278,1410,1439,1444,1478,1490,1496,1516,1613,1633,1715,1733,1739,1744,1894,1899,2009,2015,2050,2070,2076,2231],{"type":43,"tag":44,"props":45,"children":46},"element","h1",{"id":4},[47],{"type":48,"value":4},"text",{"type":43,"tag":50,"props":51,"children":52},"p",{},[53,55,64,66,73],{"type":48,"value":54},"Bootstraps an opinionated 3-pane tmux session for end-to-end Workflow SDK development. Each pane is launched through ",{"type":43,"tag":56,"props":57,"children":61},"a",{"href":58,"rel":59},"https:\u002F\u002Fgithub.com\u002Faleclarson\u002Fportless",[60],"nofollow",[62],{"type":48,"value":63},"portless",{"type":48,"value":65}," so URLs are stable and worktree-scoped (e.g. ",{"type":43,"tag":67,"props":68,"children":70},"code",{"className":69},[],[71],{"type":48,"value":72},"https:\u002F\u002F\u003Cbranch>.turbopack.localhost",{"type":48,"value":74},"), letting multiple worktrees run concurrently without port conflicts. A companion statusline script surfaces the active URLs in Claude Code's prompt.",{"type":43,"tag":50,"props":76,"children":77},{},[78,80,86,88,94],{"type":48,"value":79},"This is ",{"type":43,"tag":81,"props":82,"children":83},"strong",{},[84],{"type":48,"value":85},"opt-in contributor tooling",{"type":48,"value":87},". The repo's standard dev path (",{"type":43,"tag":67,"props":89,"children":91},{"className":90},[],[92],{"type":48,"value":93},"pnpm dev",{"type":48,"value":95}," from a workbench, no portless) is unaffected.",{"type":43,"tag":97,"props":98,"children":100},"h2",{"id":99},"prerequisites",[101],{"type":48,"value":102},"Prerequisites",{"type":43,"tag":104,"props":105,"children":106},"ul",{},[107,119,145,182],{"type":43,"tag":108,"props":109,"children":110},"li",{},[111,117],{"type":43,"tag":67,"props":112,"children":114},{"className":113},[],[115],{"type":48,"value":116},"tmux",{"type":48,"value":118}," installed",{"type":43,"tag":108,"props":120,"children":121},{},[122,127,129,135,137,143],{"type":43,"tag":67,"props":123,"children":125},{"className":124},[],[126],{"type":48,"value":63},{"type":48,"value":128}," installed globally (",{"type":43,"tag":67,"props":130,"children":132},{"className":131},[],[133],{"type":48,"value":134},"npm i -g portless",{"type":48,"value":136}," or via Homebrew). Verify with ",{"type":43,"tag":67,"props":138,"children":140},{"className":139},[],[141],{"type":48,"value":142},"portless --version",{"type":48,"value":144},".",{"type":43,"tag":108,"props":146,"children":147},{},[148,150,156,158,164,166,172,174,180],{"type":48,"value":149},"Repo bootstrapped: ",{"type":43,"tag":67,"props":151,"children":153},{"className":152},[],[154],{"type":48,"value":155},"pnpm install && pnpm build",{"type":48,"value":157},". The first run on a fresh worktree must complete both before any dev server can start (the workbench apps depend on built workspace packages — without ",{"type":43,"tag":67,"props":159,"children":161},{"className":160},[],[162],{"type":48,"value":163},"pnpm build",{"type":48,"value":165}," you get ",{"type":43,"tag":67,"props":167,"children":169},{"className":168},[],[170],{"type":48,"value":171},"MODULE_NOT_FOUND",{"type":48,"value":173}," for ",{"type":43,"tag":67,"props":175,"children":177},{"className":176},[],[178],{"type":48,"value":179},"workflow",{"type":48,"value":181},").",{"type":43,"tag":108,"props":183,"children":184},{},[185,191,193,199],{"type":43,"tag":67,"props":186,"children":188},{"className":187},[],[189],{"type":48,"value":190},"WORKFLOW_PUBLIC_MANIFEST=1",{"type":48,"value":192}," is required on the dev server when running e2e tests against it (otherwise ",{"type":43,"tag":67,"props":194,"children":196},{"className":195},[],[197],{"type":48,"value":198},"\u002F.well-known\u002Fworkflow\u002Fv1\u002Fmanifest.json",{"type":48,"value":200}," is gated).",{"type":43,"tag":97,"props":202,"children":204},{"id":203},"layout",[205],{"type":48,"value":206},"Layout",{"type":43,"tag":50,"props":208,"children":209},{},[210,216],{"type":43,"tag":67,"props":211,"children":213},{"className":212},[],[214],{"type":48,"value":215},"main-vertical",{"type":48,"value":217}," — the dev server takes the left column; the right column stacks the observability UI on top of a scratchpad shell:",{"type":43,"tag":219,"props":220,"children":224},"pre",{"className":221,"code":223,"language":48},[222],"language-text","+----------------------+--------------------------+\n|                      |  PANE_OBS: workflow web  |\n|                      |  (observability UI       |\n|  PANE_DEV: turbopack |   scoped to the          |\n|  (Next.js dev)       |   workbench app)         |\n|                      +--------------------------+\n|                      |  PANE_SH: zsh scratchpad |\n|                      |  (repo root — for build, |\n|                      |   tests, e2e, git, etc.) |\n+----------------------+--------------------------+\n",[225],{"type":43,"tag":67,"props":226,"children":228},{"__ignoreMap":227},"",[229],{"type":48,"value":223},{"type":43,"tag":97,"props":231,"children":233},{"id":232},"setup",[234],{"type":48,"value":235},"Setup",{"type":43,"tag":50,"props":237,"children":238},{},[239,241,246,248,254],{"type":48,"value":240},"The session name ",{"type":43,"tag":81,"props":242,"children":243},{},[244],{"type":48,"value":245},"must",{"type":48,"value":247}," match the worktree's portless prefix — the basename of the current branch — so the statusline (and any other tooling that derives the prefix from the branch) can locate it. Always run ",{"type":43,"tag":67,"props":249,"children":251},{"className":250},[],[252],{"type":48,"value":253},"tmux ls",{"type":48,"value":255}," first to confirm there's no pre-existing session with that name; never kill an existing one.",{"type":43,"tag":50,"props":257,"children":258},{},[259,261,267,269,275],{"type":48,"value":260},"Pane indices in tmux depend on ",{"type":43,"tag":67,"props":262,"children":264},{"className":263},[],[265],{"type":48,"value":266},"pane-base-index",{"type":48,"value":268}," (0 by default, 1 with the common dotfile override). To stay correct under either, capture each pane's ID at split time with ",{"type":43,"tag":67,"props":270,"children":272},{"className":271},[],[273],{"type":48,"value":274},"-P -F '#{pane_id}'",{"type":48,"value":276}," and use those IDs as targets:",{"type":43,"tag":219,"props":278,"children":282},{"className":279,"code":280,"language":281,"meta":227,"style":227},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","REPO=\u002Fpath\u002Fto\u002Fworkflow--\u003Cworktree-suffix>\n# Session name = basename of the branch (matches portless's subdomain prefix\n# and the statusline's `tmux attach -t \u003Cprefix>` indicator). For branch\n# `pgp\u002Ffoo-bar` this resolves to `foo-bar`.\nSESSION=$(git -C \"$REPO\" rev-parse --abbrev-ref HEAD)\nSESSION=\"${SESSION##*\u002F}\"\n\n# Create the session and capture the initial pane ID\nPANE_DEV=$(tmux new-session -d -s \"$SESSION\" -c \"$REPO\" -P -F '#{pane_id}')\nPANE_OBS=$(tmux split-window -h -t \"$PANE_DEV\" -c \"$REPO\" -P -F '#{pane_id}')\nPANE_SH=$(tmux split-window -v -t \"$PANE_OBS\" -c \"$REPO\" -P -F '#{pane_id}')\ntmux select-layout -t \"$SESSION\" main-vertical\n\n# Pane DEV (left): Next.js turbopack workbench, with manifest exposed for e2e\ntmux send-keys -t \"$PANE_DEV\" \\\n  'cd workbench\u002Fnextjs-turbopack && WORKFLOW_PUBLIC_MANIFEST=1 portless run --name turbopack pnpm dev' C-m\n\n# Pane OBS (top-right): observability UI scoped to the workbench app\ntmux send-keys -t \"$PANE_OBS\" \\\n  'cd workbench\u002Fnextjs-turbopack && portless run --name workflow-obs sh -c \"pnpm workflow web --webPort \\$PORT --noBrowser\"' C-m\n\n# Pane SH (bottom-right): scratchpad at repo root\ntmux send-keys -t \"$PANE_SH\" 'echo \"scratchpad: $(pwd)\"' C-m\n\ntmux attach -t \"$SESSION\"\n","bash",[283],{"type":43,"tag":67,"props":284,"children":285},{"__ignoreMap":227},[286,325,335,344,353,413,439,449,458,549,634,717,751,759,768,802,825,833,842,874,895,903,912,958,966],{"type":43,"tag":287,"props":288,"children":291},"span",{"class":289,"line":290},"line",1,[292,298,304,310,315,320],{"type":43,"tag":287,"props":293,"children":295},{"style":294},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[296],{"type":48,"value":297},"REPO",{"type":43,"tag":287,"props":299,"children":301},{"style":300},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[302],{"type":48,"value":303},"=",{"type":43,"tag":287,"props":305,"children":307},{"style":306},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[308],{"type":48,"value":309},"\u002Fpath\u002Fto\u002Fworkflow--",{"type":43,"tag":287,"props":311,"children":312},{"style":300},[313],{"type":48,"value":314},"\u003C",{"type":43,"tag":287,"props":316,"children":317},{"style":306},[318],{"type":48,"value":319},"worktree-suffix",{"type":43,"tag":287,"props":321,"children":322},{"style":300},[323],{"type":48,"value":324},">\n",{"type":43,"tag":287,"props":326,"children":328},{"class":289,"line":327},2,[329],{"type":43,"tag":287,"props":330,"children":332},{"style":331},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[333],{"type":48,"value":334},"# Session name = basename of the branch (matches portless's subdomain prefix\n",{"type":43,"tag":287,"props":336,"children":338},{"class":289,"line":337},3,[339],{"type":43,"tag":287,"props":340,"children":341},{"style":331},[342],{"type":48,"value":343},"# and the statusline's `tmux attach -t \u003Cprefix>` indicator). For branch\n",{"type":43,"tag":287,"props":345,"children":347},{"class":289,"line":346},4,[348],{"type":43,"tag":287,"props":349,"children":350},{"style":331},[351],{"type":48,"value":352},"# `pgp\u002Ffoo-bar` this resolves to `foo-bar`.\n",{"type":43,"tag":287,"props":354,"children":356},{"class":289,"line":355},5,[357,362,367,373,378,383,388,393,398,403,408],{"type":43,"tag":287,"props":358,"children":359},{"style":294},[360],{"type":48,"value":361},"SESSION",{"type":43,"tag":287,"props":363,"children":364},{"style":300},[365],{"type":48,"value":366},"=$(",{"type":43,"tag":287,"props":368,"children":370},{"style":369},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[371],{"type":48,"value":372},"git",{"type":43,"tag":287,"props":374,"children":375},{"style":306},[376],{"type":48,"value":377}," -C",{"type":43,"tag":287,"props":379,"children":380},{"style":300},[381],{"type":48,"value":382}," \"",{"type":43,"tag":287,"props":384,"children":385},{"style":294},[386],{"type":48,"value":387},"$REPO",{"type":43,"tag":287,"props":389,"children":390},{"style":300},[391],{"type":48,"value":392},"\"",{"type":43,"tag":287,"props":394,"children":395},{"style":306},[396],{"type":48,"value":397}," rev-parse",{"type":43,"tag":287,"props":399,"children":400},{"style":306},[401],{"type":48,"value":402}," --abbrev-ref",{"type":43,"tag":287,"props":404,"children":405},{"style":306},[406],{"type":48,"value":407}," HEAD",{"type":43,"tag":287,"props":409,"children":410},{"style":300},[411],{"type":48,"value":412},")\n",{"type":43,"tag":287,"props":414,"children":416},{"class":289,"line":415},6,[417,421,425,430,434],{"type":43,"tag":287,"props":418,"children":419},{"style":294},[420],{"type":48,"value":361},{"type":43,"tag":287,"props":422,"children":423},{"style":300},[424],{"type":48,"value":303},{"type":43,"tag":287,"props":426,"children":427},{"style":300},[428],{"type":48,"value":429},"\"${",{"type":43,"tag":287,"props":431,"children":432},{"style":294},[433],{"type":48,"value":361},{"type":43,"tag":287,"props":435,"children":436},{"style":300},[437],{"type":48,"value":438},"##*\u002F}\"\n",{"type":43,"tag":287,"props":440,"children":442},{"class":289,"line":441},7,[443],{"type":43,"tag":287,"props":444,"children":446},{"emptyLinePlaceholder":445},true,[447],{"type":48,"value":448},"\n",{"type":43,"tag":287,"props":450,"children":452},{"class":289,"line":451},8,[453],{"type":43,"tag":287,"props":454,"children":455},{"style":331},[456],{"type":48,"value":457},"# Create the session and capture the initial pane ID\n",{"type":43,"tag":287,"props":459,"children":461},{"class":289,"line":460},9,[462,467,471,475,480,485,490,494,499,503,508,512,516,520,525,530,535,540,545],{"type":43,"tag":287,"props":463,"children":464},{"style":294},[465],{"type":48,"value":466},"PANE_DEV",{"type":43,"tag":287,"props":468,"children":469},{"style":300},[470],{"type":48,"value":366},{"type":43,"tag":287,"props":472,"children":473},{"style":369},[474],{"type":48,"value":116},{"type":43,"tag":287,"props":476,"children":477},{"style":306},[478],{"type":48,"value":479}," new-session",{"type":43,"tag":287,"props":481,"children":482},{"style":306},[483],{"type":48,"value":484}," -d",{"type":43,"tag":287,"props":486,"children":487},{"style":306},[488],{"type":48,"value":489}," -s",{"type":43,"tag":287,"props":491,"children":492},{"style":300},[493],{"type":48,"value":382},{"type":43,"tag":287,"props":495,"children":496},{"style":294},[497],{"type":48,"value":498},"$SESSION",{"type":43,"tag":287,"props":500,"children":501},{"style":300},[502],{"type":48,"value":392},{"type":43,"tag":287,"props":504,"children":505},{"style":306},[506],{"type":48,"value":507}," -c",{"type":43,"tag":287,"props":509,"children":510},{"style":300},[511],{"type":48,"value":382},{"type":43,"tag":287,"props":513,"children":514},{"style":294},[515],{"type":48,"value":387},{"type":43,"tag":287,"props":517,"children":518},{"style":300},[519],{"type":48,"value":392},{"type":43,"tag":287,"props":521,"children":522},{"style":306},[523],{"type":48,"value":524}," -P",{"type":43,"tag":287,"props":526,"children":527},{"style":306},[528],{"type":48,"value":529}," -F",{"type":43,"tag":287,"props":531,"children":532},{"style":300},[533],{"type":48,"value":534}," '",{"type":43,"tag":287,"props":536,"children":537},{"style":306},[538],{"type":48,"value":539},"#{pane_id}",{"type":43,"tag":287,"props":541,"children":542},{"style":300},[543],{"type":48,"value":544},"'",{"type":43,"tag":287,"props":546,"children":547},{"style":300},[548],{"type":48,"value":412},{"type":43,"tag":287,"props":550,"children":552},{"class":289,"line":551},10,[553,558,562,566,571,576,581,585,590,594,598,602,606,610,614,618,622,626,630],{"type":43,"tag":287,"props":554,"children":555},{"style":294},[556],{"type":48,"value":557},"PANE_OBS",{"type":43,"tag":287,"props":559,"children":560},{"style":300},[561],{"type":48,"value":366},{"type":43,"tag":287,"props":563,"children":564},{"style":369},[565],{"type":48,"value":116},{"type":43,"tag":287,"props":567,"children":568},{"style":306},[569],{"type":48,"value":570}," split-window",{"type":43,"tag":287,"props":572,"children":573},{"style":306},[574],{"type":48,"value":575}," -h",{"type":43,"tag":287,"props":577,"children":578},{"style":306},[579],{"type":48,"value":580}," -t",{"type":43,"tag":287,"props":582,"children":583},{"style":300},[584],{"type":48,"value":382},{"type":43,"tag":287,"props":586,"children":587},{"style":294},[588],{"type":48,"value":589},"$PANE_DEV",{"type":43,"tag":287,"props":591,"children":592},{"style":300},[593],{"type":48,"value":392},{"type":43,"tag":287,"props":595,"children":596},{"style":306},[597],{"type":48,"value":507},{"type":43,"tag":287,"props":599,"children":600},{"style":300},[601],{"type":48,"value":382},{"type":43,"tag":287,"props":603,"children":604},{"style":294},[605],{"type":48,"value":387},{"type":43,"tag":287,"props":607,"children":608},{"style":300},[609],{"type":48,"value":392},{"type":43,"tag":287,"props":611,"children":612},{"style":306},[613],{"type":48,"value":524},{"type":43,"tag":287,"props":615,"children":616},{"style":306},[617],{"type":48,"value":529},{"type":43,"tag":287,"props":619,"children":620},{"style":300},[621],{"type":48,"value":534},{"type":43,"tag":287,"props":623,"children":624},{"style":306},[625],{"type":48,"value":539},{"type":43,"tag":287,"props":627,"children":628},{"style":300},[629],{"type":48,"value":544},{"type":43,"tag":287,"props":631,"children":632},{"style":300},[633],{"type":48,"value":412},{"type":43,"tag":287,"props":635,"children":637},{"class":289,"line":636},11,[638,643,647,651,655,660,664,668,673,677,681,685,689,693,697,701,705,709,713],{"type":43,"tag":287,"props":639,"children":640},{"style":294},[641],{"type":48,"value":642},"PANE_SH",{"type":43,"tag":287,"props":644,"children":645},{"style":300},[646],{"type":48,"value":366},{"type":43,"tag":287,"props":648,"children":649},{"style":369},[650],{"type":48,"value":116},{"type":43,"tag":287,"props":652,"children":653},{"style":306},[654],{"type":48,"value":570},{"type":43,"tag":287,"props":656,"children":657},{"style":306},[658],{"type":48,"value":659}," -v",{"type":43,"tag":287,"props":661,"children":662},{"style":306},[663],{"type":48,"value":580},{"type":43,"tag":287,"props":665,"children":666},{"style":300},[667],{"type":48,"value":382},{"type":43,"tag":287,"props":669,"children":670},{"style":294},[671],{"type":48,"value":672},"$PANE_OBS",{"type":43,"tag":287,"props":674,"children":675},{"style":300},[676],{"type":48,"value":392},{"type":43,"tag":287,"props":678,"children":679},{"style":306},[680],{"type":48,"value":507},{"type":43,"tag":287,"props":682,"children":683},{"style":300},[684],{"type":48,"value":382},{"type":43,"tag":287,"props":686,"children":687},{"style":294},[688],{"type":48,"value":387},{"type":43,"tag":287,"props":690,"children":691},{"style":300},[692],{"type":48,"value":392},{"type":43,"tag":287,"props":694,"children":695},{"style":306},[696],{"type":48,"value":524},{"type":43,"tag":287,"props":698,"children":699},{"style":306},[700],{"type":48,"value":529},{"type":43,"tag":287,"props":702,"children":703},{"style":300},[704],{"type":48,"value":534},{"type":43,"tag":287,"props":706,"children":707},{"style":306},[708],{"type":48,"value":539},{"type":43,"tag":287,"props":710,"children":711},{"style":300},[712],{"type":48,"value":544},{"type":43,"tag":287,"props":714,"children":715},{"style":300},[716],{"type":48,"value":412},{"type":43,"tag":287,"props":718,"children":720},{"class":289,"line":719},12,[721,725,730,734,738,742,746],{"type":43,"tag":287,"props":722,"children":723},{"style":369},[724],{"type":48,"value":116},{"type":43,"tag":287,"props":726,"children":727},{"style":306},[728],{"type":48,"value":729}," select-layout",{"type":43,"tag":287,"props":731,"children":732},{"style":306},[733],{"type":48,"value":580},{"type":43,"tag":287,"props":735,"children":736},{"style":300},[737],{"type":48,"value":382},{"type":43,"tag":287,"props":739,"children":740},{"style":294},[741],{"type":48,"value":498},{"type":43,"tag":287,"props":743,"children":744},{"style":300},[745],{"type":48,"value":392},{"type":43,"tag":287,"props":747,"children":748},{"style":306},[749],{"type":48,"value":750}," main-vertical\n",{"type":43,"tag":287,"props":752,"children":754},{"class":289,"line":753},13,[755],{"type":43,"tag":287,"props":756,"children":757},{"emptyLinePlaceholder":445},[758],{"type":48,"value":448},{"type":43,"tag":287,"props":760,"children":762},{"class":289,"line":761},14,[763],{"type":43,"tag":287,"props":764,"children":765},{"style":331},[766],{"type":48,"value":767},"# Pane DEV (left): Next.js turbopack workbench, with manifest exposed for e2e\n",{"type":43,"tag":287,"props":769,"children":771},{"class":289,"line":770},15,[772,776,781,785,789,793,797],{"type":43,"tag":287,"props":773,"children":774},{"style":369},[775],{"type":48,"value":116},{"type":43,"tag":287,"props":777,"children":778},{"style":306},[779],{"type":48,"value":780}," send-keys",{"type":43,"tag":287,"props":782,"children":783},{"style":306},[784],{"type":48,"value":580},{"type":43,"tag":287,"props":786,"children":787},{"style":300},[788],{"type":48,"value":382},{"type":43,"tag":287,"props":790,"children":791},{"style":294},[792],{"type":48,"value":589},{"type":43,"tag":287,"props":794,"children":795},{"style":300},[796],{"type":48,"value":392},{"type":43,"tag":287,"props":798,"children":799},{"style":294},[800],{"type":48,"value":801}," \\\n",{"type":43,"tag":287,"props":803,"children":805},{"class":289,"line":804},16,[806,811,816,820],{"type":43,"tag":287,"props":807,"children":808},{"style":300},[809],{"type":48,"value":810},"  '",{"type":43,"tag":287,"props":812,"children":813},{"style":306},[814],{"type":48,"value":815},"cd workbench\u002Fnextjs-turbopack && WORKFLOW_PUBLIC_MANIFEST=1 portless run --name turbopack pnpm dev",{"type":43,"tag":287,"props":817,"children":818},{"style":300},[819],{"type":48,"value":544},{"type":43,"tag":287,"props":821,"children":822},{"style":306},[823],{"type":48,"value":824}," C-m\n",{"type":43,"tag":287,"props":826,"children":828},{"class":289,"line":827},17,[829],{"type":43,"tag":287,"props":830,"children":831},{"emptyLinePlaceholder":445},[832],{"type":48,"value":448},{"type":43,"tag":287,"props":834,"children":836},{"class":289,"line":835},18,[837],{"type":43,"tag":287,"props":838,"children":839},{"style":331},[840],{"type":48,"value":841},"# Pane OBS (top-right): observability UI scoped to the workbench app\n",{"type":43,"tag":287,"props":843,"children":845},{"class":289,"line":844},19,[846,850,854,858,862,866,870],{"type":43,"tag":287,"props":847,"children":848},{"style":369},[849],{"type":48,"value":116},{"type":43,"tag":287,"props":851,"children":852},{"style":306},[853],{"type":48,"value":780},{"type":43,"tag":287,"props":855,"children":856},{"style":306},[857],{"type":48,"value":580},{"type":43,"tag":287,"props":859,"children":860},{"style":300},[861],{"type":48,"value":382},{"type":43,"tag":287,"props":863,"children":864},{"style":294},[865],{"type":48,"value":672},{"type":43,"tag":287,"props":867,"children":868},{"style":300},[869],{"type":48,"value":392},{"type":43,"tag":287,"props":871,"children":872},{"style":294},[873],{"type":48,"value":801},{"type":43,"tag":287,"props":875,"children":877},{"class":289,"line":876},20,[878,882,887,891],{"type":43,"tag":287,"props":879,"children":880},{"style":300},[881],{"type":48,"value":810},{"type":43,"tag":287,"props":883,"children":884},{"style":306},[885],{"type":48,"value":886},"cd workbench\u002Fnextjs-turbopack && portless run --name workflow-obs sh -c \"pnpm workflow web --webPort \\$PORT --noBrowser\"",{"type":43,"tag":287,"props":888,"children":889},{"style":300},[890],{"type":48,"value":544},{"type":43,"tag":287,"props":892,"children":893},{"style":306},[894],{"type":48,"value":824},{"type":43,"tag":287,"props":896,"children":898},{"class":289,"line":897},21,[899],{"type":43,"tag":287,"props":900,"children":901},{"emptyLinePlaceholder":445},[902],{"type":48,"value":448},{"type":43,"tag":287,"props":904,"children":906},{"class":289,"line":905},22,[907],{"type":43,"tag":287,"props":908,"children":909},{"style":331},[910],{"type":48,"value":911},"# Pane SH (bottom-right): scratchpad at repo root\n",{"type":43,"tag":287,"props":913,"children":915},{"class":289,"line":914},23,[916,920,924,928,932,937,941,945,950,954],{"type":43,"tag":287,"props":917,"children":918},{"style":369},[919],{"type":48,"value":116},{"type":43,"tag":287,"props":921,"children":922},{"style":306},[923],{"type":48,"value":780},{"type":43,"tag":287,"props":925,"children":926},{"style":306},[927],{"type":48,"value":580},{"type":43,"tag":287,"props":929,"children":930},{"style":300},[931],{"type":48,"value":382},{"type":43,"tag":287,"props":933,"children":934},{"style":294},[935],{"type":48,"value":936},"$PANE_SH",{"type":43,"tag":287,"props":938,"children":939},{"style":300},[940],{"type":48,"value":392},{"type":43,"tag":287,"props":942,"children":943},{"style":300},[944],{"type":48,"value":534},{"type":43,"tag":287,"props":946,"children":947},{"style":306},[948],{"type":48,"value":949},"echo \"scratchpad: $(pwd)\"",{"type":43,"tag":287,"props":951,"children":952},{"style":300},[953],{"type":48,"value":544},{"type":43,"tag":287,"props":955,"children":956},{"style":306},[957],{"type":48,"value":824},{"type":43,"tag":287,"props":959,"children":961},{"class":289,"line":960},24,[962],{"type":43,"tag":287,"props":963,"children":964},{"emptyLinePlaceholder":445},[965],{"type":48,"value":448},{"type":43,"tag":287,"props":967,"children":969},{"class":289,"line":968},25,[970,974,979,983,987,991],{"type":43,"tag":287,"props":971,"children":972},{"style":369},[973],{"type":48,"value":116},{"type":43,"tag":287,"props":975,"children":976},{"style":306},[977],{"type":48,"value":978}," attach",{"type":43,"tag":287,"props":980,"children":981},{"style":306},[982],{"type":48,"value":580},{"type":43,"tag":287,"props":984,"children":985},{"style":300},[986],{"type":48,"value":382},{"type":43,"tag":287,"props":988,"children":989},{"style":294},[990],{"type":48,"value":498},{"type":43,"tag":287,"props":992,"children":993},{"style":300},[994],{"type":48,"value":995},"\"\n",{"type":43,"tag":50,"props":997,"children":998},{},[999,1001,1007,1009,1015,1017,1023],{"type":48,"value":1000},"Once both servers are ready, ",{"type":43,"tag":67,"props":1002,"children":1004},{"className":1003},[],[1005],{"type":48,"value":1006},"portless list",{"type":48,"value":1008}," shows the routes. With ",{"type":43,"tag":67,"props":1010,"children":1012},{"className":1011},[],[1013],{"type":48,"value":1014},"portless run",{"type":48,"value":1016},", each linked worktree gets a unique branch-prefixed subdomain (e.g. ",{"type":43,"tag":67,"props":1018,"children":1020},{"className":1019},[],[1021],{"type":48,"value":1022},"stepflow-test.turbopack.localhost",{"type":48,"value":1024},"), so multiple worktrees coexist without changing config.",{"type":43,"tag":97,"props":1026,"children":1028},{"id":1027},"why-each-piece",[1029],{"type":48,"value":1030},"Why each piece",{"type":43,"tag":104,"props":1032,"children":1033},{},[1034,1072,1122,1168,1181],{"type":43,"tag":108,"props":1035,"children":1036},{},[1037,1046,1048,1054,1056,1062,1064,1070],{"type":43,"tag":81,"props":1038,"children":1039},{},[1040],{"type":43,"tag":67,"props":1041,"children":1043},{"className":1042},[],[1044],{"type":48,"value":1045},"portless run --name \u003Cname>",{"type":48,"value":1047}," (instead of ",{"type":43,"tag":67,"props":1049,"children":1051},{"className":1050},[],[1052],{"type":48,"value":1053},"portless \u003Cname> \u003Ccmd>",{"type":48,"value":1055},"): ",{"type":43,"tag":67,"props":1057,"children":1059},{"className":1058},[],[1060],{"type":48,"value":1061},"run",{"type":48,"value":1063}," auto-detects git worktrees and prepends the sanitized branch name as a subdomain. The ",{"type":43,"tag":67,"props":1065,"children":1067},{"className":1066},[],[1068],{"type":48,"value":1069},"--name",{"type":48,"value":1071}," flag overrides the inferred base name while preserving the worktree prefix.",{"type":43,"tag":108,"props":1073,"children":1074},{},[1075,1084,1085,1090,1092,1098,1100,1105,1107,1112,1114,1120],{"type":43,"tag":81,"props":1076,"children":1077},{},[1078],{"type":43,"tag":67,"props":1079,"children":1081},{"className":1080},[],[1082],{"type":48,"value":1083},"pnpm workflow web --webPort $PORT --noBrowser",{"type":48,"value":1047},{"type":43,"tag":67,"props":1086,"children":1088},{"className":1087},[],[1089],{"type":48,"value":93},{"type":48,"value":1091}," in ",{"type":43,"tag":67,"props":1093,"children":1095},{"className":1094},[],[1096],{"type":48,"value":1097},"packages\u002Fweb",{"type":48,"value":1099},"): the bundled CLI starts the observability UI configured against the ",{"type":43,"tag":81,"props":1101,"children":1102},{},[1103],{"type":48,"value":1104},"current workbench app",{"type":48,"value":1106},", hydrating it with that project's local World data. Running ",{"type":43,"tag":67,"props":1108,"children":1110},{"className":1109},[],[1111],{"type":48,"value":1097},{"type":48,"value":1113},"'s own ",{"type":43,"tag":67,"props":1115,"children":1117},{"className":1116},[],[1118],{"type":48,"value":1119},"dev",{"type":48,"value":1121}," script gives you the UI but pointed at nothing.",{"type":43,"tag":108,"props":1123,"children":1124},{},[1125,1134,1136,1142,1144,1150,1152,1158,1160,1166],{"type":43,"tag":81,"props":1126,"children":1127},{},[1128],{"type":43,"tag":67,"props":1129,"children":1131},{"className":1130},[],[1132],{"type":48,"value":1133},"sh -c '... --webPort $PORT'",{"type":48,"value":1135},": portless's auto ",{"type":43,"tag":67,"props":1137,"children":1139},{"className":1138},[],[1140],{"type":48,"value":1141},"--port",{"type":48,"value":1143}," injection only triggers for known frameworks it can detect on the command line. When the command is a CLI wrapper (",{"type":43,"tag":67,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":48,"value":1149},"pnpm workflow web",{"type":48,"value":1151},"), wrap in ",{"type":43,"tag":67,"props":1153,"children":1155},{"className":1154},[],[1156],{"type":48,"value":1157},"sh -c",{"type":48,"value":1159}," and read ",{"type":43,"tag":67,"props":1161,"children":1163},{"className":1162},[],[1164],{"type":48,"value":1165},"$PORT",{"type":48,"value":1167}," (which portless always sets) explicitly.",{"type":43,"tag":108,"props":1169,"children":1170},{},[1171,1179],{"type":43,"tag":81,"props":1172,"children":1173},{},[1174],{"type":43,"tag":67,"props":1175,"children":1177},{"className":1176},[],[1178],{"type":48,"value":190},{"type":48,"value":1180}," on the dev pane: required for e2e tests to fetch the workflow registry from the dev server.",{"type":43,"tag":108,"props":1182,"children":1183},{},[1184,1192,1194,1199],{"type":43,"tag":81,"props":1185,"children":1186},{},[1187],{"type":43,"tag":67,"props":1188,"children":1190},{"className":1189},[],[1191],{"type":48,"value":274},{"type":48,"value":1193},": makes the snippet correct regardless of the user's ",{"type":43,"tag":67,"props":1195,"children":1197},{"className":1196},[],[1198],{"type":48,"value":266},{"type":48,"value":1200}," setting (defaults vary across configs).",{"type":43,"tag":97,"props":1202,"children":1204},{"id":1203},"claude-statusline-integration",[1205],{"type":48,"value":1206},"Claude statusline integration",{"type":43,"tag":50,"props":1208,"children":1209},{},[1210,1212,1218],{"type":48,"value":1211},"The skill ships a statusline helper at ",{"type":43,"tag":67,"props":1213,"children":1215},{"className":1214},[],[1216],{"type":48,"value":1217},"skills\u002Finternal-dev-workbench\u002Fstatusline.sh",{"type":48,"value":1219}," that derives the worktree prefix from the current branch and emits a compact line:",{"type":43,"tag":219,"props":1221,"children":1224},{"className":1222,"code":1223,"language":48},[222]," dev  ·   obs  ·   tmux attach -t \u003Cworktree-prefix>\n",[1225],{"type":43,"tag":67,"props":1226,"children":1227},{"__ignoreMap":227},[1228],{"type":48,"value":1223},{"type":43,"tag":50,"props":1230,"children":1231},{},[1232,1234,1240,1242,1248],{"type":48,"value":1233},"The dev \u002F obs labels (Nerd Font rocket \u002F graph glyphs) are OSC 8 hyperlinks — clickable in iTerm2, Kitty, WezTerm, Terminal.app, Ghostty — styled bold + underlined + bright cyan so they read unambiguously as links. The tmux fragment (Nerd Font copy glyph) is bold bright green, signaling \"copy this\" rather than \"click this\". It's shown only when a session named exactly the worktree prefix exists, and it's printed as a full ready-to-paste ",{"type":43,"tag":67,"props":1235,"children":1237},{"className":1236},[],[1238],{"type":48,"value":1239},"tmux attach -t \u003Cprefix>",{"type":48,"value":1241}," invocation. The font must include Nerd Font glyphs for the icons to render correctly; without them you'll see substitution boxes but the layout still works. Each piece is independent — if portless has no ",{"type":43,"tag":67,"props":1243,"children":1245},{"className":1244},[],[1246],{"type":48,"value":1247},"\u003Cprefix>.turbopack.localhost",{"type":48,"value":1249}," route, the dev fragment is omitted, and so on. With nothing to show, the script prints nothing and the statusline stays silent.",{"type":43,"tag":50,"props":1251,"children":1252},{},[1253,1255,1261,1263,1268,1270,1276],{"type":48,"value":1254},"Wire it into ",{"type":43,"tag":67,"props":1256,"children":1258},{"className":1257},[],[1259],{"type":48,"value":1260},"~\u002F.claude\u002Fsettings.json",{"type":48,"value":1262}," so it works across all sessions and worktrees. ",{"type":43,"tag":81,"props":1264,"children":1265},{},[1266],{"type":48,"value":1267},"Point the path at your primary checkout, not at a worktree",{"type":48,"value":1269}," — worktrees get deleted, so any path like ",{"type":43,"tag":67,"props":1271,"children":1273},{"className":1272},[],[1274],{"type":48,"value":1275},"~\u002Fgithub\u002Fvercel\u002Fworkflow--\u003Cbranch>\u002F...",{"type":48,"value":1277}," will break the day you remove that worktree:",{"type":43,"tag":219,"props":1279,"children":1283},{"className":1280,"code":1281,"language":1282,"meta":227,"style":227},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"$HOME\u002Fgithub\u002Fvercel\u002Fworkflow\u002Fskills\u002Finternal-dev-workbench\u002Fstatusline.sh\"\n  }\n}\n","json",[1284],{"type":43,"tag":67,"props":1285,"children":1286},{"__ignoreMap":227},[1287,1295,1323,1362,1394,1402],{"type":43,"tag":287,"props":1288,"children":1289},{"class":289,"line":290},[1290],{"type":43,"tag":287,"props":1291,"children":1292},{"style":300},[1293],{"type":48,"value":1294},"{\n",{"type":43,"tag":287,"props":1296,"children":1297},{"class":289,"line":327},[1298,1303,1309,1313,1318],{"type":43,"tag":287,"props":1299,"children":1300},{"style":300},[1301],{"type":48,"value":1302},"  \"",{"type":43,"tag":287,"props":1304,"children":1306},{"style":1305},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1307],{"type":48,"value":1308},"statusLine",{"type":43,"tag":287,"props":1310,"children":1311},{"style":300},[1312],{"type":48,"value":392},{"type":43,"tag":287,"props":1314,"children":1315},{"style":300},[1316],{"type":48,"value":1317},":",{"type":43,"tag":287,"props":1319,"children":1320},{"style":300},[1321],{"type":48,"value":1322}," {\n",{"type":43,"tag":287,"props":1324,"children":1325},{"class":289,"line":337},[1326,1331,1336,1340,1344,1348,1353,1357],{"type":43,"tag":287,"props":1327,"children":1328},{"style":300},[1329],{"type":48,"value":1330},"    \"",{"type":43,"tag":287,"props":1332,"children":1333},{"style":369},[1334],{"type":48,"value":1335},"type",{"type":43,"tag":287,"props":1337,"children":1338},{"style":300},[1339],{"type":48,"value":392},{"type":43,"tag":287,"props":1341,"children":1342},{"style":300},[1343],{"type":48,"value":1317},{"type":43,"tag":287,"props":1345,"children":1346},{"style":300},[1347],{"type":48,"value":382},{"type":43,"tag":287,"props":1349,"children":1350},{"style":306},[1351],{"type":48,"value":1352},"command",{"type":43,"tag":287,"props":1354,"children":1355},{"style":300},[1356],{"type":48,"value":392},{"type":43,"tag":287,"props":1358,"children":1359},{"style":300},[1360],{"type":48,"value":1361},",\n",{"type":43,"tag":287,"props":1363,"children":1364},{"class":289,"line":346},[1365,1369,1373,1377,1381,1385,1390],{"type":43,"tag":287,"props":1366,"children":1367},{"style":300},[1368],{"type":48,"value":1330},{"type":43,"tag":287,"props":1370,"children":1371},{"style":369},[1372],{"type":48,"value":1352},{"type":43,"tag":287,"props":1374,"children":1375},{"style":300},[1376],{"type":48,"value":392},{"type":43,"tag":287,"props":1378,"children":1379},{"style":300},[1380],{"type":48,"value":1317},{"type":43,"tag":287,"props":1382,"children":1383},{"style":300},[1384],{"type":48,"value":382},{"type":43,"tag":287,"props":1386,"children":1387},{"style":306},[1388],{"type":48,"value":1389},"$HOME\u002Fgithub\u002Fvercel\u002Fworkflow\u002Fskills\u002Finternal-dev-workbench\u002Fstatusline.sh",{"type":43,"tag":287,"props":1391,"children":1392},{"style":300},[1393],{"type":48,"value":995},{"type":43,"tag":287,"props":1395,"children":1396},{"class":289,"line":355},[1397],{"type":43,"tag":287,"props":1398,"children":1399},{"style":300},[1400],{"type":48,"value":1401},"  }\n",{"type":43,"tag":287,"props":1403,"children":1404},{"class":289,"line":415},[1405],{"type":43,"tag":287,"props":1406,"children":1407},{"style":300},[1408],{"type":48,"value":1409},"}\n",{"type":43,"tag":50,"props":1411,"children":1412},{},[1413,1415,1421,1423,1429,1431,1437],{"type":48,"value":1414},"Adjust the prefix if your main checkout lives elsewhere. The script itself is worktree-aware: it reads Claude's ",{"type":43,"tag":67,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":48,"value":1420},"workspace.current_dir",{"type":48,"value":1422}," from stdin to derive the current branch, so the ",{"type":43,"tag":1424,"props":1425,"children":1426},"em",{},[1427],{"type":48,"value":1428},"same script invocation",{"type":48,"value":1430}," from ",{"type":43,"tag":67,"props":1432,"children":1434},{"className":1433},[],[1435],{"type":48,"value":1436},"~\u002Fgithub\u002Fvercel\u002Fworkflow\u002F...",{"type":48,"value":1438}," correctly surfaces routes for whichever worktree the Claude session is running in.",{"type":43,"tag":50,"props":1440,"children":1441},{},[1442],{"type":48,"value":1443},"Output rules:",{"type":43,"tag":104,"props":1445,"children":1446},{},[1447,1452,1457],{"type":43,"tag":108,"props":1448,"children":1449},{},[1450],{"type":48,"value":1451},"Nothing to show (no matching portless route, no matching tmux session) → empty output.",{"type":43,"tag":108,"props":1453,"children":1454},{},[1455],{"type":48,"value":1456},"Each piece appears independently — start a server but no tmux session and you'll see just the dev\u002Fobs fragments; the reverse shows just the tmux fragment.",{"type":43,"tag":108,"props":1458,"children":1459},{},[1460,1462,1468,1470,1476],{"type":48,"value":1461},"No git context but routes exist → falls back to the first matching ",{"type":43,"tag":67,"props":1463,"children":1465},{"className":1464},[],[1466],{"type":48,"value":1467},"turbopack",{"type":48,"value":1469},"\u002F",{"type":43,"tag":67,"props":1471,"children":1473},{"className":1472},[],[1474],{"type":48,"value":1475},"workflow-obs",{"type":48,"value":1477}," route, no tmux indicator.",{"type":43,"tag":50,"props":1479,"children":1480},{},[1481,1483,1488],{"type":48,"value":1482},"If you already use a statusline and want to append the internal-dev-workbench info, run the helper and concatenate in your existing wrapper script instead of replacing ",{"type":43,"tag":67,"props":1484,"children":1486},{"className":1485},[],[1487],{"type":48,"value":1352},{"type":48,"value":1489}," outright.",{"type":43,"tag":97,"props":1491,"children":1493},{"id":1492},"restarting-after-editing-workflow-files",[1494],{"type":48,"value":1495},"Restarting after editing workflow files",{"type":43,"tag":50,"props":1497,"children":1498},{},[1499,1501,1507,1509,1514],{"type":48,"value":1500},"The workflow manifest is built at dev-server startup. New workflows or steps added to ",{"type":43,"tag":67,"props":1502,"children":1504},{"className":1503},[],[1505],{"type":48,"value":1506},"workbench\u002Fexample\u002Fworkflows\u002F*.ts",{"type":48,"value":1508}," (and their symlinks in other workbenches) ",{"type":43,"tag":81,"props":1510,"children":1511},{},[1512],{"type":48,"value":1513},"do not appear at runtime",{"type":48,"value":1515}," — even with HMR — until the dev server restarts.",{"type":43,"tag":219,"props":1517,"children":1519},{"className":279,"code":1518,"language":281,"meta":227,"style":227},"tmux send-keys -t \"$PANE_DEV\" C-c\n# Wait for the prompt to return\ntmux send-keys -t \"$PANE_DEV\" \\\n  'cd workbench\u002Fnextjs-turbopack && WORKFLOW_PUBLIC_MANIFEST=1 portless run --name turbopack pnpm dev' C-m\n",[1520],{"type":43,"tag":67,"props":1521,"children":1522},{"__ignoreMap":227},[1523,1555,1563,1594],{"type":43,"tag":287,"props":1524,"children":1525},{"class":289,"line":290},[1526,1530,1534,1538,1542,1546,1550],{"type":43,"tag":287,"props":1527,"children":1528},{"style":369},[1529],{"type":48,"value":116},{"type":43,"tag":287,"props":1531,"children":1532},{"style":306},[1533],{"type":48,"value":780},{"type":43,"tag":287,"props":1535,"children":1536},{"style":306},[1537],{"type":48,"value":580},{"type":43,"tag":287,"props":1539,"children":1540},{"style":300},[1541],{"type":48,"value":382},{"type":43,"tag":287,"props":1543,"children":1544},{"style":294},[1545],{"type":48,"value":589},{"type":43,"tag":287,"props":1547,"children":1548},{"style":300},[1549],{"type":48,"value":392},{"type":43,"tag":287,"props":1551,"children":1552},{"style":306},[1553],{"type":48,"value":1554}," C-c\n",{"type":43,"tag":287,"props":1556,"children":1557},{"class":289,"line":327},[1558],{"type":43,"tag":287,"props":1559,"children":1560},{"style":331},[1561],{"type":48,"value":1562},"# Wait for the prompt to return\n",{"type":43,"tag":287,"props":1564,"children":1565},{"class":289,"line":337},[1566,1570,1574,1578,1582,1586,1590],{"type":43,"tag":287,"props":1567,"children":1568},{"style":369},[1569],{"type":48,"value":116},{"type":43,"tag":287,"props":1571,"children":1572},{"style":306},[1573],{"type":48,"value":780},{"type":43,"tag":287,"props":1575,"children":1576},{"style":306},[1577],{"type":48,"value":580},{"type":43,"tag":287,"props":1579,"children":1580},{"style":300},[1581],{"type":48,"value":382},{"type":43,"tag":287,"props":1583,"children":1584},{"style":294},[1585],{"type":48,"value":589},{"type":43,"tag":287,"props":1587,"children":1588},{"style":300},[1589],{"type":48,"value":392},{"type":43,"tag":287,"props":1591,"children":1592},{"style":294},[1593],{"type":48,"value":801},{"type":43,"tag":287,"props":1595,"children":1596},{"class":289,"line":346},[1597,1601,1605,1609],{"type":43,"tag":287,"props":1598,"children":1599},{"style":300},[1600],{"type":48,"value":810},{"type":43,"tag":287,"props":1602,"children":1603},{"style":306},[1604],{"type":48,"value":815},{"type":43,"tag":287,"props":1606,"children":1607},{"style":300},[1608],{"type":48,"value":544},{"type":43,"tag":287,"props":1610,"children":1611},{"style":306},[1612],{"type":48,"value":824},{"type":43,"tag":50,"props":1614,"children":1615},{},[1616,1618,1623,1625,1631],{"type":48,"value":1617},"Verify the new workflow is registered (use the portless-assigned local port from ",{"type":43,"tag":67,"props":1619,"children":1621},{"className":1620},[],[1622],{"type":48,"value":1006},{"type":48,"value":1624},", or the ",{"type":43,"tag":67,"props":1626,"children":1628},{"className":1627},[],[1629],{"type":48,"value":1630},".localhost",{"type":48,"value":1632}," URL with the trusted CA):",{"type":43,"tag":219,"props":1634,"children":1636},{"className":279,"code":1635,"language":281,"meta":227,"style":227},"\u002Fusr\u002Fbin\u002Fcurl -s \"$(portless get turbopack)\u002F.well-known\u002Fworkflow\u002Fv1\u002Fmanifest.json\" \\\n  | grep -o '\u003Cyour-new-workflow>'\n",[1637],{"type":43,"tag":67,"props":1638,"children":1639},{"__ignoreMap":227},[1640,1683],{"type":43,"tag":287,"props":1641,"children":1642},{"class":289,"line":290},[1643,1648,1652,1657,1661,1666,1671,1675,1679],{"type":43,"tag":287,"props":1644,"children":1645},{"style":369},[1646],{"type":48,"value":1647},"\u002Fusr\u002Fbin\u002Fcurl",{"type":43,"tag":287,"props":1649,"children":1650},{"style":306},[1651],{"type":48,"value":489},{"type":43,"tag":287,"props":1653,"children":1654},{"style":300},[1655],{"type":48,"value":1656}," \"$(",{"type":43,"tag":287,"props":1658,"children":1659},{"style":369},[1660],{"type":48,"value":63},{"type":43,"tag":287,"props":1662,"children":1663},{"style":306},[1664],{"type":48,"value":1665}," get turbopack",{"type":43,"tag":287,"props":1667,"children":1668},{"style":300},[1669],{"type":48,"value":1670},")",{"type":43,"tag":287,"props":1672,"children":1673},{"style":306},[1674],{"type":48,"value":198},{"type":43,"tag":287,"props":1676,"children":1677},{"style":300},[1678],{"type":48,"value":392},{"type":43,"tag":287,"props":1680,"children":1681},{"style":294},[1682],{"type":48,"value":801},{"type":43,"tag":287,"props":1684,"children":1685},{"class":289,"line":327},[1686,1691,1696,1701,1705,1710],{"type":43,"tag":287,"props":1687,"children":1688},{"style":300},[1689],{"type":48,"value":1690},"  |",{"type":43,"tag":287,"props":1692,"children":1693},{"style":369},[1694],{"type":48,"value":1695}," grep",{"type":43,"tag":287,"props":1697,"children":1698},{"style":306},[1699],{"type":48,"value":1700}," -o",{"type":43,"tag":287,"props":1702,"children":1703},{"style":300},[1704],{"type":48,"value":534},{"type":43,"tag":287,"props":1706,"children":1707},{"style":306},[1708],{"type":48,"value":1709},"\u003Cyour-new-workflow>",{"type":43,"tag":287,"props":1711,"children":1712},{"style":300},[1713],{"type":48,"value":1714},"'\n",{"type":43,"tag":50,"props":1716,"children":1717},{},[1718,1724,1726,1732],{"type":43,"tag":67,"props":1719,"children":1721},{"className":1720},[],[1722],{"type":48,"value":1723},"NODE_EXTRA_CA_CERTS=\u002Ftmp\u002Fportless\u002Fca.pem",{"type":48,"value":1725}," is needed for Node clients hitting the HTTPS URL outside of portless-managed children. Browsers are fine after ",{"type":43,"tag":67,"props":1727,"children":1729},{"className":1728},[],[1730],{"type":48,"value":1731},"portless trust",{"type":48,"value":144},{"type":43,"tag":97,"props":1734,"children":1736},{"id":1735},"running-e2e-tests-against-this-session",[1737],{"type":48,"value":1738},"Running e2e tests against this session",{"type":43,"tag":50,"props":1740,"children":1741},{},[1742],{"type":48,"value":1743},"From the scratchpad pane. Use the portless-assigned local port to bypass TLS for the test runner:",{"type":43,"tag":219,"props":1745,"children":1747},{"className":279,"code":1746,"language":281,"meta":227,"style":227},"PORT=$(portless list | awk '\u002Fturbopack\u002F {n=split($3,a,\":\"); print a[n]; exit}')\nDEPLOYMENT_URL=\"http:\u002F\u002Flocalhost:$PORT\" APP_NAME=\"nextjs-turbopack\" \\\n  pnpm vitest run packages\u002Fcore\u002Fe2e\u002Fe2e.test.ts -t \"\u003Ctest name>\"\n",[1748],{"type":43,"tag":67,"props":1749,"children":1750},{"__ignoreMap":227},[1751,1799,1854],{"type":43,"tag":287,"props":1752,"children":1753},{"class":289,"line":290},[1754,1759,1763,1767,1772,1777,1782,1786,1791,1795],{"type":43,"tag":287,"props":1755,"children":1756},{"style":294},[1757],{"type":48,"value":1758},"PORT",{"type":43,"tag":287,"props":1760,"children":1761},{"style":300},[1762],{"type":48,"value":366},{"type":43,"tag":287,"props":1764,"children":1765},{"style":369},[1766],{"type":48,"value":63},{"type":43,"tag":287,"props":1768,"children":1769},{"style":306},[1770],{"type":48,"value":1771}," list",{"type":43,"tag":287,"props":1773,"children":1774},{"style":300},[1775],{"type":48,"value":1776}," |",{"type":43,"tag":287,"props":1778,"children":1779},{"style":369},[1780],{"type":48,"value":1781}," awk",{"type":43,"tag":287,"props":1783,"children":1784},{"style":300},[1785],{"type":48,"value":534},{"type":43,"tag":287,"props":1787,"children":1788},{"style":306},[1789],{"type":48,"value":1790},"\u002Fturbopack\u002F {n=split($3,a,\":\"); print a[n]; exit}",{"type":43,"tag":287,"props":1792,"children":1793},{"style":300},[1794],{"type":48,"value":544},{"type":43,"tag":287,"props":1796,"children":1797},{"style":300},[1798],{"type":48,"value":412},{"type":43,"tag":287,"props":1800,"children":1801},{"class":289,"line":327},[1802,1807,1811,1815,1820,1824,1828,1833,1837,1841,1846,1850],{"type":43,"tag":287,"props":1803,"children":1804},{"style":294},[1805],{"type":48,"value":1806},"DEPLOYMENT_URL",{"type":43,"tag":287,"props":1808,"children":1809},{"style":300},[1810],{"type":48,"value":303},{"type":43,"tag":287,"props":1812,"children":1813},{"style":300},[1814],{"type":48,"value":392},{"type":43,"tag":287,"props":1816,"children":1817},{"style":306},[1818],{"type":48,"value":1819},"http:\u002F\u002Flocalhost:",{"type":43,"tag":287,"props":1821,"children":1822},{"style":294},[1823],{"type":48,"value":1165},{"type":43,"tag":287,"props":1825,"children":1826},{"style":300},[1827],{"type":48,"value":392},{"type":43,"tag":287,"props":1829,"children":1830},{"style":294},[1831],{"type":48,"value":1832}," APP_NAME",{"type":43,"tag":287,"props":1834,"children":1835},{"style":300},[1836],{"type":48,"value":303},{"type":43,"tag":287,"props":1838,"children":1839},{"style":300},[1840],{"type":48,"value":392},{"type":43,"tag":287,"props":1842,"children":1843},{"style":306},[1844],{"type":48,"value":1845},"nextjs-turbopack",{"type":43,"tag":287,"props":1847,"children":1848},{"style":300},[1849],{"type":48,"value":392},{"type":43,"tag":287,"props":1851,"children":1852},{"style":369},[1853],{"type":48,"value":801},{"type":43,"tag":287,"props":1855,"children":1856},{"class":289,"line":337},[1857,1862,1867,1872,1877,1881,1885,1890],{"type":43,"tag":287,"props":1858,"children":1859},{"style":306},[1860],{"type":48,"value":1861},"  pnpm",{"type":43,"tag":287,"props":1863,"children":1864},{"style":306},[1865],{"type":48,"value":1866}," vitest",{"type":43,"tag":287,"props":1868,"children":1869},{"style":306},[1870],{"type":48,"value":1871}," run",{"type":43,"tag":287,"props":1873,"children":1874},{"style":306},[1875],{"type":48,"value":1876}," packages\u002Fcore\u002Fe2e\u002Fe2e.test.ts",{"type":43,"tag":287,"props":1878,"children":1879},{"style":306},[1880],{"type":48,"value":580},{"type":43,"tag":287,"props":1882,"children":1883},{"style":300},[1884],{"type":48,"value":382},{"type":43,"tag":287,"props":1886,"children":1887},{"style":306},[1888],{"type":48,"value":1889},"\u003Ctest name>",{"type":43,"tag":287,"props":1891,"children":1892},{"style":300},[1893],{"type":48,"value":995},{"type":43,"tag":50,"props":1895,"children":1896},{},[1897],{"type":48,"value":1898},"Or use the portless URL with the CA trust:",{"type":43,"tag":219,"props":1900,"children":1902},{"className":279,"code":1901,"language":281,"meta":227,"style":227},"NODE_EXTRA_CA_CERTS=\u002Ftmp\u002Fportless\u002Fca.pem \\\n  DEPLOYMENT_URL=\"$(portless get turbopack)\" APP_NAME=\"nextjs-turbopack\" \\\n  pnpm vitest run packages\u002Fcore\u002Fe2e\u002Fe2e.test.ts -t \"\u003Ctest name>\"\n",[1903],{"type":43,"tag":67,"props":1904,"children":1905},{"__ignoreMap":227},[1906,1927,1974],{"type":43,"tag":287,"props":1907,"children":1908},{"class":289,"line":290},[1909,1914,1918,1923],{"type":43,"tag":287,"props":1910,"children":1911},{"style":294},[1912],{"type":48,"value":1913},"NODE_EXTRA_CA_CERTS",{"type":43,"tag":287,"props":1915,"children":1916},{"style":300},[1917],{"type":48,"value":303},{"type":43,"tag":287,"props":1919,"children":1920},{"style":306},[1921],{"type":48,"value":1922},"\u002Ftmp\u002Fportless\u002Fca.pem",{"type":43,"tag":287,"props":1924,"children":1925},{"style":369},[1926],{"type":48,"value":801},{"type":43,"tag":287,"props":1928,"children":1929},{"class":289,"line":327},[1930,1935,1940,1944,1948,1953,1958,1962,1966,1970],{"type":43,"tag":287,"props":1931,"children":1932},{"style":306},[1933],{"type":48,"value":1934},"  DEPLOYMENT_URL=",{"type":43,"tag":287,"props":1936,"children":1937},{"style":300},[1938],{"type":48,"value":1939},"\"$(",{"type":43,"tag":287,"props":1941,"children":1942},{"style":369},[1943],{"type":48,"value":63},{"type":43,"tag":287,"props":1945,"children":1946},{"style":306},[1947],{"type":48,"value":1665},{"type":43,"tag":287,"props":1949,"children":1950},{"style":300},[1951],{"type":48,"value":1952},")\"",{"type":43,"tag":287,"props":1954,"children":1955},{"style":306},[1956],{"type":48,"value":1957}," APP_NAME=",{"type":43,"tag":287,"props":1959,"children":1960},{"style":300},[1961],{"type":48,"value":392},{"type":43,"tag":287,"props":1963,"children":1964},{"style":306},[1965],{"type":48,"value":1845},{"type":43,"tag":287,"props":1967,"children":1968},{"style":300},[1969],{"type":48,"value":392},{"type":43,"tag":287,"props":1971,"children":1972},{"style":294},[1973],{"type":48,"value":801},{"type":43,"tag":287,"props":1975,"children":1976},{"class":289,"line":337},[1977,1981,1985,1989,1993,1997,2001,2005],{"type":43,"tag":287,"props":1978,"children":1979},{"style":306},[1980],{"type":48,"value":1861},{"type":43,"tag":287,"props":1982,"children":1983},{"style":306},[1984],{"type":48,"value":1866},{"type":43,"tag":287,"props":1986,"children":1987},{"style":306},[1988],{"type":48,"value":1871},{"type":43,"tag":287,"props":1990,"children":1991},{"style":306},[1992],{"type":48,"value":1876},{"type":43,"tag":287,"props":1994,"children":1995},{"style":306},[1996],{"type":48,"value":580},{"type":43,"tag":287,"props":1998,"children":1999},{"style":300},[2000],{"type":48,"value":382},{"type":43,"tag":287,"props":2002,"children":2003},{"style":306},[2004],{"type":48,"value":1889},{"type":43,"tag":287,"props":2006,"children":2007},{"style":300},[2008],{"type":48,"value":995},{"type":43,"tag":97,"props":2010,"children":2012},{"id":2011},"teardown",[2013],{"type":48,"value":2014},"Teardown",{"type":43,"tag":219,"props":2016,"children":2018},{"className":279,"code":2017,"language":281,"meta":227,"style":227},"tmux kill-session -t \"$SESSION\"\n",[2019],{"type":43,"tag":67,"props":2020,"children":2021},{"__ignoreMap":227},[2022],{"type":43,"tag":287,"props":2023,"children":2024},{"class":289,"line":290},[2025,2029,2034,2038,2042,2046],{"type":43,"tag":287,"props":2026,"children":2027},{"style":369},[2028],{"type":48,"value":116},{"type":43,"tag":287,"props":2030,"children":2031},{"style":306},[2032],{"type":48,"value":2033}," kill-session",{"type":43,"tag":287,"props":2035,"children":2036},{"style":306},[2037],{"type":48,"value":580},{"type":43,"tag":287,"props":2039,"children":2040},{"style":300},[2041],{"type":48,"value":382},{"type":43,"tag":287,"props":2043,"children":2044},{"style":294},[2045],{"type":48,"value":498},{"type":43,"tag":287,"props":2047,"children":2048},{"style":300},[2049],{"type":48,"value":995},{"type":43,"tag":50,"props":2051,"children":2052},{},[2053,2055,2060,2062,2068],{"type":48,"value":2054},"Portless removes routes when each child process exits (Ctrl+C the panes first if you want a clean ",{"type":43,"tag":67,"props":2056,"children":2058},{"className":2057},[],[2059],{"type":48,"value":1006},{"type":48,"value":2061},"). The proxy itself keeps running for other sessions; stop it explicitly with ",{"type":43,"tag":67,"props":2063,"children":2065},{"className":2064},[],[2066],{"type":48,"value":2067},"portless proxy stop",{"type":48,"value":2069}," if needed.",{"type":43,"tag":97,"props":2071,"children":2073},{"id":2072},"troubleshooting",[2074],{"type":48,"value":2075},"Troubleshooting",{"type":43,"tag":104,"props":2077,"children":2078},{},[2079,2100,2124,2163,2181,2199],{"type":43,"tag":108,"props":2080,"children":2081},{},[2082,2091,2093,2098],{"type":43,"tag":81,"props":2083,"children":2084},{},[2085],{"type":43,"tag":67,"props":2086,"children":2088},{"className":2087},[],[2089],{"type":48,"value":2090},"MODULE_NOT_FOUND: 'workflow'",{"type":48,"value":2092}," in the dev pane — workspace packages haven't been built. Run ",{"type":43,"tag":67,"props":2094,"children":2096},{"className":2095},[],[2097],{"type":48,"value":163},{"type":48,"value":2099}," from the repo root, then restart the pane.",{"type":43,"tag":108,"props":2101,"children":2102},{},[2103,2108,2110,2116,2118,2123],{"type":43,"tag":81,"props":2104,"children":2105},{},[2106],{"type":48,"value":2107},"Observability UI shows no runs",{"type":48,"value":2109}," — verify the obs pane was started from inside ",{"type":43,"tag":67,"props":2111,"children":2113},{"className":2112},[],[2114],{"type":48,"value":2115},"workbench\u002Fnextjs-turbopack",{"type":48,"value":2117}," (or whichever workbench you want to inspect). The CLI reads the local World from the ",{"type":43,"tag":81,"props":2119,"children":2120},{},[2121],{"type":48,"value":2122},"current working directory",{"type":48,"value":144},{"type":43,"tag":108,"props":2125,"children":2126},{},[2127,2140,2142,2147,2148,2153,2155,2161],{"type":43,"tag":81,"props":2128,"children":2129},{},[2130,2132,2138],{"type":48,"value":2131},"react-router on ",{"type":43,"tag":67,"props":2133,"children":2135},{"className":2134},[],[2136],{"type":48,"value":2137},":5173",{"type":48,"value":2139}," instead of the portless port",{"type":48,"value":2141}," — happens when the obs pane uses ",{"type":43,"tag":67,"props":2143,"children":2145},{"className":2144},[],[2146],{"type":48,"value":93},{"type":48,"value":1430},{"type":43,"tag":67,"props":2149,"children":2151},{"className":2150},[],[2152],{"type":48,"value":1097},{"type":48,"value":2154},". Switch to the ",{"type":43,"tag":67,"props":2156,"children":2158},{"className":2157},[],[2159],{"type":48,"value":2160},"pnpm workflow web --webPort $PORT",{"type":48,"value":2162}," form above.",{"type":43,"tag":108,"props":2164,"children":2165},{},[2166,2171,2173,2179],{"type":43,"tag":81,"props":2167,"children":2168},{},[2169],{"type":48,"value":2170},"Source-map warning on startup",{"type":48,"value":2172}," (",{"type":43,"tag":67,"props":2174,"children":2176},{"className":2175},[],[2177],{"type":48,"value":2178},"failed to read input source map ... packages\u002Fserde\u002Fdist\u002Findex.js.map",{"type":48,"value":2180},") — benign; doesn't block dev.",{"type":43,"tag":108,"props":2182,"children":2183},{},[2184,2189,2191,2197],{"type":43,"tag":81,"props":2185,"children":2186},{},[2187],{"type":48,"value":2188},"Stale workflow registration",{"type":48,"value":2190}," after editing ",{"type":43,"tag":67,"props":2192,"children":2194},{"className":2193},[],[2195],{"type":48,"value":2196},"99_e2e.ts",{"type":48,"value":2198}," — restart the dev pane; HMR doesn't rebuild the manifest.",{"type":43,"tag":108,"props":2200,"children":2201},{},[2202,2207,2209,2214,2216,2222,2224,2230],{"type":43,"tag":81,"props":2203,"children":2204},{},[2205],{"type":48,"value":2206},"Statusline shows nothing",{"type":48,"value":2208}," — confirm ",{"type":43,"tag":67,"props":2210,"children":2212},{"className":2211},[],[2213],{"type":48,"value":1006},{"type":48,"value":2215}," has at least one matching route, the path in ",{"type":43,"tag":67,"props":2217,"children":2219},{"className":2218},[],[2220],{"type":48,"value":2221},"settings.json",{"type":48,"value":2223}," is absolute, and the script is executable (",{"type":43,"tag":67,"props":2225,"children":2227},{"className":2226},[],[2228],{"type":48,"value":2229},"chmod +x",{"type":48,"value":181},{"type":43,"tag":2232,"props":2233,"children":2234},"style",{},[2235],{"type":48,"value":2236},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2238,"total":346},[2239,2246,2260,2274],{"slug":4,"name":4,"fn":5,"description":6,"org":2240,"tags":2241,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2242,2243,2244,2245],{"name":21,"slug":22,"type":15},{"name":18,"slug":19,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"slug":2247,"name":2247,"fn":2248,"description":2249,"org":2250,"tags":2251,"stars":23,"repoUrl":24,"updatedAt":2259},"migrating-to-workflow-sdk","migrate workflows to Vercel Workflow SDK","Migrates Temporal, Inngest, Trigger.dev, and AWS Step Functions workflows to the Workflow SDK. Use when porting Activities, Workers, Signals, step.run(), step.waitForEvent(), Trigger.dev tasks \u002F wait.forToken \u002F triggerAndWait, ASL JSON state machines, Task\u002FChoice\u002FWait\u002FParallel states, task tokens, or child workflows.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2252,2255,2256],{"name":2253,"slug":2254,"type":15},"Migration","migration",{"name":9,"slug":8,"type":15},{"name":2257,"slug":2258,"type":15},"Workflow Automation","workflow-automation","2026-04-13T05:21:00.819323",{"slug":179,"name":179,"fn":2261,"description":2262,"org":2263,"tags":2264,"stars":23,"repoUrl":24,"updatedAt":2273},"build durable workflows with Vercel","Creates durable, resumable workflows using Vercel's Workflow SDK. Use when building workflows that need to survive restarts, pause for external events, retry on failure, or coordinate multi-step operations over time. Triggers on mentions of \"workflow\", \"durable functions\", \"resumable\", \"workflow sdk\", \"queue\", \"event\", \"push\", \"subscribe\", or step-based orchestration.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2265,2268,2271,2272],{"name":2266,"slug":2267,"type":15},"Backend","backend",{"name":2269,"slug":2270,"type":15},"SDK","sdk",{"name":9,"slug":8,"type":15},{"name":2257,"slug":2258,"type":15},"2026-04-06T18:55:58.915052",{"slug":2275,"name":2275,"fn":2276,"description":2277,"org":2278,"tags":2279,"stars":23,"repoUrl":24,"updatedAt":2286},"workflow-init","initialize Vercel Workflow SDK","Install and configure Vercel Workflow SDK before it exists in node_modules. Use when the user asks to \"install workflow\", \"set up workflow\", \"add durable workflows\", \"configure workflow sdk\", or \"init workflow\" for Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, or Vite.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2280,2283,2284,2285],{"name":2281,"slug":2282,"type":15},"Node.js","node-js",{"name":2269,"slug":2270,"type":15},{"name":9,"slug":8,"type":15},{"name":2257,"slug":2258,"type":15},"2026-04-06T18:56:00.193699",{"items":2288,"total":2459},[2289,2309,2323,2340,2351,2366,2382,2398,2410,2427,2439,2449],{"slug":2290,"name":2290,"fn":2291,"description":2292,"org":2293,"tags":2294,"stars":2306,"repoUrl":2307,"updatedAt":2308},"next-cache-components-adoption","enable and migrate to Next.js Cache Components","Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender \u002F instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2295,2298,2301,2302,2305],{"name":2296,"slug":2297,"type":15},"Caching","caching",{"name":2299,"slug":2300,"type":15},"Frontend","frontend",{"name":2253,"slug":2254,"type":15},{"name":2303,"slug":2304,"type":15},"Next.js","next-js",{"name":9,"slug":8,"type":15},141208,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fnext.js","2026-07-24T05:38:30.118542",{"slug":2310,"name":2310,"fn":2311,"description":2312,"org":2313,"tags":2314,"stars":2306,"repoUrl":2307,"updatedAt":2322},"next-cache-components-optimizer","optimize Next.js cache components","Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components \u002F PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next\u002Fplaywright instant() e2e and work it to green, one verified route at a time; the shipped test then guards against regression. Use when asked to make a route's navigation instant (its static shell commits immediately), fix a route whose static shell isn't prerendered\u002Fserved\u002Fprefetched, grow a route's static shell or fix its slow first paint, diagnose which Suspense boundary keeps a route out of its static shell, or write the instant() e2e guard for one. Requires Next.js 16.3+ with cacheComponents; directs an upgrade if older.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2315,2316,2317,2318,2321],{"name":2296,"slug":2297,"type":15},{"name":2299,"slug":2300,"type":15},{"name":2303,"slug":2304,"type":15},{"name":2319,"slug":2320,"type":15},"Performance","performance",{"name":9,"slug":8,"type":15},"2026-07-30T05:31:10.674078",{"slug":2324,"name":2324,"fn":2325,"description":2326,"org":2327,"tags":2328,"stars":2306,"repoUrl":2307,"updatedAt":2339},"next-dev-loop","verify Next.js runtime behavior","Verify Next.js runtime behavior after editing app code. Use this skill to confirm a change actually works in a running app — not just that it compiles or type-checks. Combines \u002F_next\u002Fmcp (Next.js's view) with agent-browser (the browser's view). Requires a running `next dev`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2329,2332,2333,2334,2335,2336],{"name":2330,"slug":2331,"type":15},"Debugging","debugging",{"name":2299,"slug":2300,"type":15},{"name":18,"slug":19,"type":15},{"name":2303,"slug":2304,"type":15},{"name":9,"slug":8,"type":15},{"name":2337,"slug":2338,"type":15},"Web Development","web-development","2026-05-22T06:45:28.627735",{"slug":2341,"name":2341,"fn":2342,"description":2343,"org":2344,"tags":2345,"stars":2306,"repoUrl":2307,"updatedAt":2350},"next-partial-prefetching-adoption","adopt Partial Prefetching in Next.js apps","Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the `partialPrefetching` flag, opt routes in with `export const prefetch = 'partial'`, audit `\u003CLink prefetch={true}>` calls, or resolve the link-prefetch-partial and instant-shell-url-data insights.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2346,2347,2348,2349],{"name":2299,"slug":2300,"type":15},{"name":2303,"slug":2304,"type":15},{"name":2319,"slug":2320,"type":15},{"name":9,"slug":8,"type":15},"2026-07-30T05:31:11.591864",{"slug":2352,"name":2352,"fn":2353,"description":2354,"org":2355,"tags":2356,"stars":2363,"repoUrl":2364,"updatedAt":2365},"turborepo","manage monorepos with Turborepo","Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines,\ndependsOn, caching, remote cache, the \"turbo\" CLI, --filter, --affected, CI optimization, environment\nvariables, internal packages, monorepo structure\u002Fbest practices, and boundaries.\n\nUse when user: configures tasks\u002Fworkflows\u002Fpipelines, creates packages, sets up\nmonorepo, shares code between apps, runs changed\u002Faffected packages, debugs cache,\nor has apps\u002Fpackages directories.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2357,2360,2361],{"name":2358,"slug":2359,"type":15},"CI\u002FCD","ci-cd",{"name":2319,"slug":2320,"type":15},{"name":2362,"slug":2352,"type":15},"Turborepo",30809,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fturborepo","2026-07-30T05:32:14.920116",{"slug":2367,"name":2367,"fn":2368,"description":2369,"org":2370,"tags":2371,"stars":2379,"repoUrl":2380,"updatedAt":2381},"add-function-examples","add AI function examples for testing","Guide for adding new AI function examples, for testing specific features against the actual provider APIs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2372,2375,2378],{"name":2373,"slug":2374,"type":15},"AI SDK","ai-sdk",{"name":2376,"slug":2377,"type":15},"Testing","testing",{"name":9,"slug":8,"type":15},25670,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fai","2026-04-06T18:55:51.318866",{"slug":2383,"name":2383,"fn":2384,"description":2385,"org":2386,"tags":2387,"stars":2379,"repoUrl":2380,"updatedAt":2397},"add-harness-package","add AI SDK harness packages","Guide for adding new AI SDK harness packages. Use when creating a new @ai-sdk\u002Fharness-\u003Cname> package that adapts a coding-agent runtime to HarnessV1.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2388,2391,2392,2395,2396],{"name":2389,"slug":2390,"type":15},"Agents","agents",{"name":2373,"slug":2374,"type":15},{"name":2393,"slug":2394,"type":15},"Harness","harness",{"name":2269,"slug":2270,"type":15},{"name":9,"slug":8,"type":15},"2026-06-18T08:29:19.858737",{"slug":2399,"name":2399,"fn":2400,"description":2401,"org":2402,"tags":2403,"stars":2379,"repoUrl":2380,"updatedAt":2409},"add-provider-package","add new provider packages to AI SDK","Guide for adding new AI provider packages to the AI SDK. Use when creating a new @ai-sdk\u002F\u003Cprovider> package to integrate an AI service into the SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2404,2405,2408],{"name":2373,"slug":2374,"type":15},{"name":2406,"slug":2407,"type":15},"API Development","api-development",{"name":9,"slug":8,"type":15},"2026-04-06T18:55:47.45549",{"slug":2411,"name":2411,"fn":2412,"description":2413,"org":2414,"tags":2415,"stars":2379,"repoUrl":2380,"updatedAt":2426},"adr-skill","create and maintain architecture decision records","Create and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept\u002Freject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2416,2419,2422,2425],{"name":2417,"slug":2418,"type":15},"ADR","adr",{"name":2420,"slug":2421,"type":15},"Architecture","architecture",{"name":2423,"slug":2424,"type":15},"Documentation","documentation",{"name":21,"slug":22,"type":15},"2026-04-06T18:55:50.043694",{"slug":2374,"name":2374,"fn":2428,"description":2429,"org":2430,"tags":2431,"stars":2379,"repoUrl":2380,"updatedAt":2438},"build AI features with Vercel AI SDK","Answer questions about the AI SDK and help build AI-powered features. Use when developers: (1) Ask about AI SDK functions like generateText, streamText, ToolLoopAgent, embed, or tools, (2) Want to build AI agents, chatbots, RAG systems, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, Google, etc.), streaming, tool calling, structured output, or embeddings, (4) Use React hooks like useChat or useCompletion. Triggers on: \"AI SDK\", \"Vercel AI SDK\", \"generateText\", \"streamText\", \"add AI to my app\", \"build an agent\", \"tool calling\", \"structured output\", \"useChat\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2432,2433,2434,2437],{"name":2389,"slug":2390,"type":15},{"name":2373,"slug":2374,"type":15},{"name":2435,"slug":2436,"type":15},"LLM","llm",{"name":9,"slug":8,"type":15},"2026-04-06T18:55:48.739463",{"slug":2440,"name":2440,"fn":2441,"description":2442,"org":2443,"tags":2444,"stars":2379,"repoUrl":2380,"updatedAt":2448},"capture-api-response-test-fixture","capture API response test fixtures","Capture API response test fixture.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2445,2446,2447],{"name":2406,"slug":2407,"type":15},{"name":2376,"slug":2377,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:55:56.374433",{"slug":2450,"name":2450,"fn":2451,"description":2452,"org":2453,"tags":2454,"stars":2379,"repoUrl":2380,"updatedAt":2458},"develop-ai-functions-example","develop AI SDK function examples","Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples\u002Fai-functions\u002Fsrc to validate provider support, demonstrate features, or create test fixtures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2455,2456,2457],{"name":2373,"slug":2374,"type":15},{"name":2376,"slug":2377,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:55:55.088956",68]