Drives CLI programs through tmux panes and asserts on captured output.
npx skills add https://github.com/toqoz/config --skill tui-acceptance-checks
Please help me install this Agent Skill. Skill: tui-acceptance-checks Source: https://github.com/toqoz/config/tree/main/home/agents/skills/tui-acceptance-checks Command: npx skills add https://github.com/toqoz/config --skill tui-acceptance-checks
This skill solves the difficulty of testing interactive command-line interfaces that rely on TTY behavior, cursor control, and complex key sequences which standard unit tests cannot reach.
Use the tui-acceptance-checks skill to initialize a new test session for the target CLI tool and verify its interactive prompt behavior.
High-intent search queries and answers about installing and using this skill.
You can automate interactive CLI testing by driving programs through tmux panes, simulating real user key chords, and asserting on captured pane content. This approach reaches full-screen UI redraws and signal handling that standard subprocess testing cannot access.
Testing TUI key bindings and signal handling involves simulating user interaction within a tmux pane to send specific key sequences like Ctrl-C. You then capture the pane output to verify the interface redraws correctly without crashing.
Yes, tmux works for testing full-screen TUI redraws by capturing pane content with exponential backoff. This polling mechanism ensures deterministic assertions on asynchronous content changes and complex TUI state transitions.
The best way to verify TTY behavior and cursor control is using tmux-based driving to simulate real terminal interaction. This bypasses standard unit tests, directly testing complex key sequences and TTY-dependent cursor control within a managed session lifecycle.
Standard subprocess testing fails to reach interactive command-line interfaces because it cannot simulate TTY behavior, cursor control, or complex key sequences. Interactive CLIs require a real terminal environment, which tmux panes provide for accurate simulation.
Yes, you need Python 3 and tmux installed to run these acceptance checks. The skill relies on shell-based helper functions and Python scripts to manage the tmux session lifecycle, capture pane content, and perform asynchronous polling.
kcns008Control tmux sessions and panes for interactive CLI workflows.
PolealphaAutomate tmux keystroke injection and scrape pane output for interactive terminals.
ripgraphicsBuild npm package CLIs with argument parsing and cross-platform support.
tilework-techAutomate isolated TUI testing workflows using tmux-based scripts.
