xonecas.io
64875
Mc

mini-coder / commit 9ded923

docs: kitty remote-control section in AGENTS.md

xonecas2026-09-26 9ded923c1187c66a76230ad5d541388584b3ff76 parent d3893fa

1 file changed

AGENTS.md+23−0
@@ -76,6 +76,29 @@ Hard constraints. Do not cross these without explicit direction:
7676 undone.
7777 - Diagnostics are local only. No telemetry, no hidden stalls.
7878
79+## Driving the TUI with kitty
80+
81+There is no `tmux` here; drive the TUI through kitty's remote control on a
82+private socket, one window per session:
83+
84+ kitty --detach --listen-on unix:/tmp/mc-<name>.sock \
85+ -o allow_remote_control=yes -o remember_window_size=no \
86+ -o initial_window_width=100c -o initial_window_height=30c \
87+ --title mc-<name> env PS1='\n$ ' bash --norc --noprofile -i
88+
89+Run every `kitty @ --to unix:/tmp/mc-<name>.sock` call through that socket; the
90+window id comes from `ls`, don't assume it. Run the app (`node src/cli.ts`) with
91+a scratch cwd so its tool calls write nowhere that matters.
92+
93+- `send-text` types literal text and never submits — Enter is its own key,
94+ `send-key enter`, and it does nothing while a turn is active.
95+- `send-key` for named keys: `enter escape ctrl+c ctrl+d shift+enter tab`.
96+- `get-text -m id:N --extent=all --ansi` returns the pane with the app's
97+ truecolor SGR — assert colors from those escapes, not from pixels;
98+ `--extent=screen` is the live screen alone.
99+- `screenshot -m id:N out.png` for the visual check; `identify` it and look at
100+ it before trusting it.
101+
79102 ## Working agreement
80103
81104 - Trace the real data flow before designing; apply guards at the narrowest