# Cross-machine embedded-terminal sync

**Captured:** 2026-05-06 (auto-extracted from harness build of BUILD_SPEC v3 — embedded-claude-terminal)

## Why deferred

The embedded terminal runs ttyd on whatever machine the user opened console-v2 on (MBP or Studio, per Tailscale routing). Studio dispatches still go via `/dispatch` (the harness skill) for builds explicitly meant to run on the remote machine. There's no "always run the embedded terminal on Studio regardless of where I opened the browser" today.

Future: route the embedded terminal to the user-elected dispatch host. Would require ttyd lifecycle to be remote-aware (the `/api/ttyd/start` route would need to know which host's process group to manage).

## Prior decisions
- BUILD_SPEC v3 §"Future work" item 6
- ADR-0008 records that the v3 IPC bridge is localhost-only by design.

## Status
- [ ] Defer until JT wants to pin terminals to Studio (e.g., for long-running heavy work where the MBP would lose state on lid-close).