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(claude): note how a send to an unstarted node is queued

Fabricio Casali809f82fec741
diff --git a/CLAUDE.md b/CLAUDE.md
index ef1965189..9d30ab5a3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2002,6 +2002,16 @@ An unrelated active canvas is not saved for a background message. Server control
its nodes through the authoritative store; the renderer barrier is a desktop concern. Mobile is
not an agent-message sender.
+**A `send` to a node that has not STARTED yet is queued, not refused** (`targetNotStarted`,
+`agent-messaging.ts`). A node opened into a project that is not on screen without `--run-now`
+exists only as a held launch until the project is viewed, so no spawn has recorded its pane owner.
+When the owner is unproven AND no session exists AND this machine holds a launch for it
+(`WorkspaceStore.heldLaunch`, the machine-local `localExec` overlay), the outcome is
+`targetNotStarted` and the deliver-on-idle queue holds it; the flush re-runs every gate against the
+pane the spawn will have proven. A LIVE pane with no proven owner stays `unproven-target-owner` —
+that refusal is the security property. The queue TTL still runs, so a project nobody opens expires
+the message (sender told). Both shells wire `heldLaunch`.
+
**A board comment that @mentions a session is a message from a PERSON** (`@shared/board-comment`,
`deliverBoardCommentFromUi` in `core/agents/agent-messaging.ts`). The comment composer's @ picker
inserts an id-based token `@[label](node:<id>)` (the id is the authority, the label only a fallback