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.

chore(release): v0.4.5

reviewfb9ba3bd99d8
diff --git a/docs/release-notes/v0.4.5.md b/docs/release-notes/v0.4.5.md
new file mode 100644
index 000000000..9e3eaf60f
--- /dev/null
+++ b/docs/release-notes/v0.4.5.md
@@ -0,0 +1,61 @@
+**Antigravity is a full agent.** Google's `agy` CLI could already be launched; it now carries
+nearly the whole harness — context links to other agent nodes, canvas control so it can open and
+arrange nodes itself, its own model catalogue read from `agy models` with switching, permission
+modes, the context meter, the ⌘M transcript view, cross-agent handoff and Open recent. Every leg
+was measured against real `agy` 1.2.7 / 1.3.5 sessions and their transcripts, and the context meter
+takes the window from the session's own settings rather than guessing one. `/loop`, `/schedule`,
+`/cron` and Branch stay Claude-only.
+
+**A whiteboard is a node.** New view ▸ New whiteboard (also the sidebar `+`, the Dock and ⌘K) puts
+an Excalidraw board on the canvas: double-click to draw in a live editor over the node, a picture of
+the board at rest, Present and Copy as image in the header. The drawing lives in a side file beside
+the project (`.nodeterm/whiteboards/`). The save path is the part worth knowing: a board open in two
+places refuses the stale write and offers **Keep mine** instead of silently replacing the other
+copy, finishing waits for a save that actually succeeded rather than throwing the last strokes away,
+quitting flushes what the 1.5 s autosave had not written yet, and a hosted Viewer or Commenter opens
+the board read-only. Not yet run by hand on Windows, Linux, or in a browser tab.
+
+**macOS Aerial video wallpapers.** Settings → Appearance → Desktop wallpaper gains an Aerials group:
+one Shuffle tile per Apple category plus a tile per clip you have downloaded, playing behind the
+canvas and the board with Liquid Glass on top. It reads macOS's own aerial files — nothing is
+bundled, downloaded or streamed — and the video pauses whenever the window is unfocused or hidden,
+because Apple's clips are 4K at 240 fps and cost about 70% of a core while they move. Off by
+default; Reduce Motion shows a still frame.
+
+**A live link can be read back.** A viewer could not scroll at all, and that was structural: tmux
+paints the visible screen, and Claude's fullscreen TUI leaves no tmux history to scroll. The viewer
+page can now ask for the shared agent's conversation — but only the part written **after** the link
+was created, with the cutoff enforced on the host, not the page. Prompts, assistant text, tool names
+with a short argument and plan or question bodies travel; tool results and thinking never do. One
+read per viewer at a time, and a revoke made elsewhere now reaches a full link within a minute
+instead of five.
+
+**An agent can rebuild an exact layout.** Canvas control gains `resize`, `place`, `arrange --gap`
+and geometry in `list`, so eight sessions in two tight columns on a vertical monitor is a CLI call
+that survives every session being replaced, instead of a drag. Sizes are clamped to each node kind's
+own minimum and the reply says when it clamped; a group frame is refused, because a frame sizes
+itself to what it holds.
+
+**A security audit round — five changes, and one of them had teeth.** The relay handshake accepted
+low-order X25519 keys, where the shared key is a public constant: a client with no secret completed
+the handshake, both people saw the same short code, and a swapped host key in an offer, join code or
+QR could read and inject every byte. Those keys are refused everywhere one can enter now. Separately,
+a scoped Team Access guest could reach terminals outside its projects because tmux resolves a bare
+target by prefix on a miss — every node id that becomes a tmux target is an exact `=name` target now,
+and a node a guest introduces stays pending until its own spawn. The Server Edition's sign-in lockout
+could be walked past by holding request bodies back; the loopback hook server refuses browser
+requests before it looks at the bearer; the native SSH transport pins the host key type it recorded,
+so a MITM holding only one key type is refused rather than quietly trusted; and a live-link Control
+lock now lifts itself on a backoff, with the unlock sealed to a per-connection key so a password
+cannot be read back out of recorded relay traffic.
+
+**Fixes you will meet.** Windows terminals run on node-pty's bundled ConPTY, so fullscreen TUIs
+scroll properly. Removing a Claude account moves its running sessions to the system account instead
+of leaving them logged out mid-session. Local dictation runs on Metal in the packaged macOS app and
+ships an AVX2 build of whisper.cpp on Linux x64. Liquid Glass stays readable at every slider
+position, and the Dock's add menu stays inside short windows. A relay or team-tab terminal never
+starts on the wrong machine, and an agent opened from an SSH project's history or a transfer runs on
+the host. Sticky notes, browsers, editors, simulators and the rest get their own default node sizes,
+a folder project's canvas can live in app data instead of inside the repo, a session's unread dot
+clears when its card opens on the global board, and the Settings debug log panel — which had never
+rendered at all — is mounted.
diff --git a/package-lock.json b/package-lock.json
index d8c9a4479..542e9fef1 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "node-terminal",
- "version": "0.4.4",
+ "version": "0.4.5",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "node-terminal",
- "version": "0.4.4",
+ "version": "0.4.5",
"hasInstallScript": true,
"license": "BUSL-1.1",
"dependencies": {
diff --git a/package.json b/package.json
index bdb805202..9941608d6 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "node-terminal",
- "version": "0.4.4",
+ "version": "0.4.5",
"engines": {
"node": "^22.22.2 || ^24.15.0 || >=26.0.0"
},