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 pull request #860 from eneskirca/fix/triage-851-20260923

eneskirca4e04343bb642
diff --cc CONTRIBUTING.md
index 87d088c1c,0de0aba61..9ea6ae9f8
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@@ -623,14 -623,21 +623,27 @@@ terminal opens keep their existing iden
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.
+ ## User-owned agent settings
+
+ Claude/Gemini settings must go through the guarded transactions in
+ `src/core/agents/hooks/{settings-file,remote-settings-file}.ts`. Confirmed absence or a successfully read empty/whitespace file may start from `{}`;
+ malformed, non-object and unreadable files must survive unchanged.
+ Keep unrelated settings and foreign hook handlers. Stage writes, serialize nodeterm writers,
+ and compare the original bytes again before publishing; never use `cat … || echo '{}'` or a
+ catch-all read fallback. Local and SSH symlinked profiles update and lock the resolved target without replacing
+ the link; recheck resolution before publishing. SSH uses plain readlink and cd -P (no GNU -f),
+ and refuses dangling/cyclic links and newline paths. A conflicting/stale lock skips installation
+ with a diagnostic naming the lock and safe manual recovery; do not steal it from another process. These locks
+ coordinate nodeterm, not external editors, so do not claim a filesystem-wide compare-and-swap.
+
## 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: