kitty-remote
通过远程协议和控制台测试工具控制 kitty 终端;启动面板/窗口,发送按键,捕获屏幕,管理套接字,以及调试远程控制故障。
📖 中文导读:通过远程协议和控制台测试工具控制 kitty 终端;启动面板/窗口,发送按键,捕获屏幕,管理套接字,以及调试远程控制故障。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: kitty-remote description: Control kitty terminal via remote protocol and kitty-test-harness; launch panels/windows, send keys, capture screen, manage sockets, and debug remote-control failures when testing TUIs. license: MIT metadata: triggers: type: domain enforcement: suggest priority: high keywords: - kitty - kitty test
Kitty Remote Control
Drive kitty instances via the remote control protocol and kitty-test-harness.
Prerequisites
- Ensure kitty is installed and on PATH.
- Enable remote control (
allow_remote_control=yesin kitty.conf or via-o). - Run under an active Wayland or X11 session.
Quick start
- Launch kitty with a unix socket (
--listen-on unix:/abs/path.sockorKITTY_LISTEN_ON). - Wait for
@ lsto succeed before sending input. - Send input with
send-textand capture output withget-text --extent screen. - Close with
close-windowand remove the socket.
Harness usage
- Prefer
kitty +kitten panelon Wayland; fall back to windows on X11/WSL - Use absolute socket paths; delete stale sockets before launch
- Send
ESCto normalize modal state before:commands - Socket disappearance = app exit/crash; capture with
@ ls,get-text --ansi, logs - Source scripts/kitty-harness.sh for ready-to-use harness
References
- harness-notes.md - internals, failure signatures, debug flow
- escape-codes.md - byte-level key sequences and modifiers