Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
docs(windows): managed account identity, shared-asset links, device checklist
review98844ce04244
diff --git a/CLAUDE.md b/CLAUDE.mdindex 640506558..6c1d16921 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -5278,7 +5278,12 @@ bridges enter live state only via `appendBridgeEdges`) and the serverremoval cancels any pending wait + `markDirty`. **Codex accounts have the same two halves** —`createCodexAccountLoginNode` (`codex login`, title "Codex login") behind the`nodeterm:add-codex-account-login` listener, with `codexAccounts.waitLogin` polling the managed- home's `auth.json`. Both flows mint an **agent-less terminal** carrying only `accountId`, and+ home's `auth.json`. **On Windows the Codex identity comes from that `auth.json`'s id_token JWT+ email (`readCodexAuthEmail` — a display label, unverified; the gate stays the real-file check),+ never the app-server**: `ws+unix` cannot dial there (`codexAppServerReachable`), so no daemon is+ started per poll and the codex title read degrades to the relayed copy. Shared assets go in via+ `linkSharedEntry` (junction / hardlink / warned copy — never a blocking EPERM; POSIX unchanged).+ Both flows mint an **agent-less terminal** carrying only `accountId`, andthat shape is why `needsCodexAccountScope` takes an `isCodexAccount` resolver rather thanreading `!!accountId`: the two account lists share an id alphabet, so the id alone cannot saywhich provider it belongs to. Guessing "codex" refused every managed **Claude** node (#345);diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex d258adf6a..e640421a0 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -472,6 +472,12 @@ anything else. Board-level fields survive every transform — `pullLinks` is oneon POSIX a backslash is legal filename text — do not treat both separators as interchangeableunless the owning filesystem is known to be Windows.+- **No unix sockets and no symlink privilege on Windows.** A `ws+unix://` dial (the Codex+ app-server) cannot work there — read the same fact from disk instead (managed Codex identity is+ the `auth.json` JWT email, `codexAppServerReachable` is the gate). An untyped `fs.symlink` throws+ EPERM on a stock account: link a shared asset through `linkSharedEntry`+ (`src/core/shared-entry-link.ts` — junction for directories, hardlink then warned copy for files).+- **Anything tmux does for us on POSIX, the session host owes on Windows.** The two delivery pathsare not symmetric and the missing half fails in the direction that LOOKS like success: `sendText`rides `tmux paste-buffer -p` on POSIX, which frames the payload from the pane's realdiff --git a/docs/codex-accounts-acceptance.md b/docs/codex-accounts-acceptance.mdindex af6b432a1..32b190bc8 100644--- a/docs/codex-accounts-acceptance.md+++ b/docs/codex-accounts-acceptance.md@@ -66,6 +66,16 @@ Codex install + a **logged-in 2nd managed account**. Headless CI cannot run themlogin completes with no email), a new Codex node on that host runs under the managed home(`echo $CODEX_HOME` in the pane), and Remove leaves no `~/.nodeterm/cx/<digest>` behind.+### Windows (managed local accounts)++- [ ] **Add + login on a stock (non-admin, no Developer Mode) account.** Add completes (no EPERM);+ `skills`/`plugins` in `~/.nodeterm/cx/<digest>` are junctions and `config.toml` a hardlink or+ (with a logged warning) a copy. `codex login` completes, the row leaves pending and shows the+ email read from `auth.json`'s id_token, and a new Codex node under that account runs with+ `CODEX_HOME` set to the managed home (`echo %CODEX_HOME%` / `$env:CODEX_HOME`).+- [ ] **System Codex row** shows the email from `%USERPROFILE%\.codex\auth.json`.+- [ ] **No `codex app-server daemon start`** process appears while a login is pending.+## Happy-path acceptance walk (the one a human runs end to end)On a real Mac with a real SSH host and a 2nd ChatGPT login available: