Documentation
¶
Overview ¶
Standalone byte-stream classifier for TUI agents — ini-szir Phase 1A artifact.
Spawns a child process under a PTY, captures its stdout for N seconds, and classifies the byte stream into prose / CSI sequences / box-drawing chars / absolute-positioning sequences. Used to answer the "does this agent's output reflow safely under a width-lie?" question that came out of ini-szir round 3.
Usage:
go run ./scripts/sniff-pane/ -- <command> [args...] go run ./scripts/sniff-pane/ -seconds 20 -cols 20 -- claude
Default: 20 columns wide, 15 seconds, no command (you must pass --).
Headline metric for ini-szir-style investigations: absolute-positioning sequences (CUP/CHA/VPA). Non-zero means the agent renders with absolute column references and would mis-render under a PTY-width lie.
NOT shipped as part of initech; lives under scripts/ as a debug tool for future investigations of the same shape (similar to scripts/keycapture/ from ini-4pk Phase 0).