Skip to content

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.

docs(windows): managed account identity, shared-asset links, device checklist

review98844ce04244
diff --git a/CLAUDE.md b/CLAUDE.md
index 640506558..6c1d16921 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5278,7 +5278,12 @@ bridges enter live state only via `appendBridgeEdges`) and the server
removal 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`, and
that shape is why `needsCodexAccountScope` takes an `isCodexAccount` resolver rather than
reading `!!accountId`: the two account lists share an id alphabet, so the id alone cannot say
which provider it belongs to. Guessing "codex" refused every managed **Claude** node (#345);
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d258adf6a..e640421a0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -472,6 +472,12 @@ anything else. Board-level fields survive every transform — `pullLinks` is one
on POSIX a backslash is legal filename text — do not treat both separators as interchangeable
unless 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 paths
are 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 real
diff --git a/docs/codex-accounts-acceptance.md b/docs/codex-accounts-acceptance.md
index 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 them
login 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: