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.

Merge main into context fix; preserve both contributor rules

reviewe45425948ec4
diff --cc CONTRIBUTING.md
index bab35faac,87d088c1c..e42cde46d
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@@ -616,17 -616,21 +616,30 @@@ examples). If the same effect also WRIT
mid-session applies stored state to whatever the user is doing right then, which is a different
feature from the one they asked for.
+**A context capacity needs session provenance.** Claude's effective `CLAUDE_CODE_MAX_CONTEXT_TOKENS`
+is reported by its managed hook, accepted only with verified node identity, and validated as a
+positive decimal safe integer. Never read the app's global env for another session or let a
+model-family guess enlarge an observed limit. Unobserved Claude windows are labelled estimates.
+The renderer rehydrates through `context.ensure`; it does not restore Claude denominators from
+storage. Other agents retain transcript-window persistence.
+Only an explicit ensure replays an unchanged live snapshot; repeated hook observations must not
+broadcast it again. Remote path, ControlMaster or connection changes replace the tracked generation.
+
+ **Command-bearing terminal opens (issue #653):** the shared hook-server route requires verified
+ node identity whenever `open-terminal` carries `cmd`, including an empty value or a dry run.
+ The strict-policy override and foreign-instance fallback cannot release this gate. Desktop plain
+ terminal opens keep their existing identity policy; Server Edition still requires verification
+ for every control verb. Legacy mobile/SSH callers must present this instance’s node token for
+ command-bearing opens; this does not add a human-confirm dialog or change mobile transport APIs.
+
## Testing
+ **Screenshot paste has one route per gesture.** On macOS, Cmd+V saves/uploads a file and
+ pastes its path; Ctrl+V belongs to the foreground program. A node's configured agent is not
+ proof of foreground clipboard-image support. Keep shell/SSH/Server file routing and capture
+ suppression of accompanying text; do not synthesize Ctrl+V or try both routes without a
+ capability and receipt protocol. The shortcuts panel documents this distinction (#712).
+
`npm test` must pass, and `npm run typecheck` is the fastest gate.
Beyond that, one habit is worth more than any other here: