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
Merge pull request #860 from eneskirca/fix/triage-851-20260923
eneskirca4e04343bb642
diff --cc CONTRIBUTING.mdindex 87d088c1c,0de0aba61..9ea6ae9f8--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@@ -623,14 -623,21 +623,27 @@@ terminal opens keep their existing idenfor every control verb. Legacy mobile/SSH callers must present this instance’s node token forcommand-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: