Kitty's clipboard protocol (mode 5522)

jeff commented

2026-10-14 20:00:57 -05:00

Owner

Kitty's clipboard protocol, mode 5522: with it on, a paste goes to the program as a kitty paste event rather than as bracketed text. Ghostty's terminal code, which harrier uses, supports it once a kitty_clipboard context exists, and that is set up only when clipboard reading is (stream_terminal.zig). harrier leaves it unset.

Left out of the clipboard-access confirmation work on purpose. Once programs can read the clipboard behind a confirmation, decide whether to turn this on, and how its reads go through the same confirmation and settings (clipboard.read, a profile's clipboard_read).

Kitty's clipboard protocol, mode 5522: with it on, a paste goes to the program as a kitty paste event rather than as bracketed text. Ghostty's terminal code, which harrier uses, supports it once a `kitty_clipboard` context exists, and that is set up only when clipboard reading is (stream_terminal.zig). harrier leaves it unset. Left out of the clipboard-access confirmation work on purpose. Once programs can read the clipboard behind a confirmation, decide whether to turn this on, and how its reads go through the same confirmation and settings (`clipboard.read`, a profile's `clipboard_read`).

jeff added the

needs-triage

label

2026-10-14 20:00:57 -05:00

jeff referenced this issue from a commit

2026-10-15 21:59:27 -05:00

Serve kitty's clipboard protocol reads and paste events

jeff closed this issue

2026-10-15 21:59:27 -05:00

jeff referenced this issue

2026-10-15 22:01:52 -05:00

Copy and paste clipboard types other than text #23

jeff commented

2026-10-15 22:01:59 -05:00

Author

Owner

Done in e262024, released in v0.4.0.

harrier now serves kitty's clipboard protocol reads (OSC 5522) and turns on its paste events (mode 5522). libghostty-vt could only answer an OSC 5522 read synchronously, inside the callback on the IO thread. The fork's zig-0.17-jeff branch now lets those replies be deferred, as OSC 52 ones already could (c7e327c4). So the reads take the same path as OSC 52:

They are asked about, allowed or refused as clipboard.read, or a profile's clipboard_read, says. "Allow for this pane" covers both protocols.
As in kitty, a read for only the list of types is not asked about, though .deny still refuses it.
A program fetching what the user just pasted, after a paste event, is neither asked nor refused: the user already pasted it.
A paste into a program with paste events on skips the unsafe-paste question, since nothing of it runs as it arrives.
Only text is handed over, under each text type the program asks for. Other types are #23.

The sway VM test covers a listing, an allowed read, and a paste event fetched with its one-time password.

Fixing the VM test also turned up a crash, fixed in d66db83: any confirmation drawn in a pane 64 cells wide or more overflowed a u7 and panicked.

Done in e262024, released in v0.4.0. harrier now serves kitty's clipboard protocol reads (OSC 5522) and turns on its paste events (mode 5522). libghostty-vt could only answer an OSC 5522 read synchronously, inside the callback on the IO thread. The fork's `zig-0.17-jeff` branch now lets those replies be deferred, as OSC 52 ones already could (c7e327c4). So the reads take the same path as OSC 52: - They are asked about, allowed or refused as `clipboard.read`, or a profile's `clipboard_read`, says. "Allow for this pane" covers both protocols. - As in kitty, a read for only the list of types is not asked about, though `.deny` still refuses it. - A program fetching what the user just pasted, after a paste event, is neither asked nor refused: the user already pasted it. - A paste into a program with paste events on skips the unsafe-paste question, since nothing of it runs as it arrives. - Only text is handed over, under each text type the program asks for. Other types are #23. The sway VM test covers a listing, an allowed read, and a paste event fetched with its one-time password. Fixing the VM test also turned up a crash, fixed in d66db83: any confirmation drawn in a pane 64 cells wide or more overflowed a `u7` and panicked.

jeff removed the

needs-triage

label

2026-10-15 22:02:00 -05:00

Rows
Columns

Kitty's clipboard protocol (mode 5522) #18