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: the ⌘M loading surfaces, the one spinner, and the label-row hint
reviewc8c7dba26301
diff --git a/CLAUDE.md b/CLAUDE.mdindex f77778fc8..8c001ad3a 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -2415,6 +2415,17 @@ command-bearing opens; this does not add a human-confirm dialog or change mobileforget-a-located-ref rule lives in `main/remote-transcript-page.ts` (a hook-fed ref is neverdropped on a failed read, and a hook event re-marks a located ref as hook-fed). Grok: oneunkeyed read, no older pages, no "Beginning of conversation" marker (a capped read cannot know).+ **Loading surfaces (2026-09).** The lazy ChatPanel chunk suspends into `ChatPanelFallback` at+ ALL THREE mount sites (canvas node, kanban card modal, closed-transcript dialog — it replaced a+ `fallback={null}` that left the ⌘M face blank over the terminal): the panel's own shell plus+ `ChatLoadingStatus`, which ChatPanel's initial "Loading conversation…" row renders too, so the+ handover is identical DOM (a second row swapped rings and re-announced its `role=status`). Its+ spinner is the app's ONE spinner, `components/Spinner` / `.nt-spinner` — frozen, not hidden,+ under `prefers-reduced-motion`; never add a local one. A terminal node's label row ends in a+ quiet ⌘M hint (`lib/mdViewHint.ts`, id `md-hint`, hideable in Settings → Appearance) naming the+ EFFECTIVE chord and what it opens on that node; it sits in a zero-basis trailing slot that+ clips, so it can never add a line to the row (a height flip would refit xterm and SIGWINCH+ tmux). It is not on the kanban card modal: that header already carries the ⌘M toggle.**The composer sends only in `done` or an unknown state** (`canSendFromChat`,`renderer/lib/chatSendGate.ts`) — never in `waiting`/`blocked`, not just never in `working`:PermissionRequest and AskUserQuestion both normalize to `waiting`, the pane then holds a TUIdiff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 9c0fa949b..25da39d88 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -373,6 +373,10 @@ lane unaffected.gone until a reload). One delegated handler (`renderer/lib/markdownLinks.ts`) intercepts clicksinside `RENDERED_MARKDOWN_CONTAINERS`; a new surface that injects markdown HTML must use one ofthose classes or join the list — `markdownLinks.test.ts` fails otherwise.+- **A loading indicator is `components/Spinner`, never a local spinner.** `.nt-spinner` is the one+ ring in `styles.css`, and it freezes under `prefers-reduced-motion`; a local copy is how a+ spinner kept rotating for users who asked for no motion, and how two rings swapped mid-load. Put+ `role="status"` on the row holding the text, not on a second spinner beside it.These are the ones that come up in review most often. Each exists because its absence caused a realbug.