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(spec): keyframes carry the host cursor and pass the output filter

reviewd1a7e61daf1a
diff --git a/docs/superpowers/specs/2026-09-28-live-share-link-design.md b/docs/superpowers/specs/2026-09-28-live-share-link-design.md
index de00920a7..558b61b51 100644
--- a/docs/superpowers/specs/2026-09-28-live-share-link-design.md
+++ b/docs/superpowers/specs/2026-09-28-live-share-link-design.md
@@ -182,7 +182,10 @@ Host → viewer:
- `ev watch:meta {v: 1, role, label, title, expiresAt, cols, rows}`
- pty output as binary `encodePtyData` frames; `ev pty:size:<sid>`
-- `ev watch:keyframe {sessionId, screen, altScreen}` — the visible screen and whether tmux paints on the alternate screen
+- `ev watch:keyframe {sessionId, screen, altScreen, cursor?}` — the visible screen, whether tmux paints on
+ the alternate screen, and the host's cursor (`{x, y}`, 0-based). The cursor is needed because tmux's
+ following stream moves the cursor relative to where it believes the tty cursor is, and a capture trims
+ trailing blanks, so a keyframe without it offsets every typed character until a full redraw.
- `ev watch:chat {id, name, text, at, from: 'viewer' | 'sharer'}`
- `ev watch:end {reason}`, `reason ∈ revoked | expired | node-gone | session-ended |
host-stopping | kicked`
@@ -290,6 +293,11 @@ does the parser give up and return to text (a lower cap would print the tail of
payload, i.e. the clipboard, as text). The parser is reset only when the viewer moves to a new pty
session, never on a keyframe.
+**Keyframes are filtered too.** `capture-pane -e` emits OSC 8 hyperlinks verbatim (measured, tmux 3.4),
+so every keyframe's screen passes a FRESH filter before it is sent (fresh because the session's stream
+filter is mid-stream state). The viewer also swallows OSC 8 at its own parser and uses an inert link
+handler: xterm's default (`linkHandler: null`) still opens an OSC 8 link after a `confirm()`.
+
### Commenter chat
- Host validation per viewer session: 1 message / 2 s, text ≤ 500 chars, name ≤ 32 chars, control