tui-testing — Claude Code skill: what it does, how to install
tui-testing is a Claude Code skill for writing unit tests for Warp's headless TUI. It validates interface elements by rendering their tree to a fixed text grid.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill tui-testing -a claude-codeWhat tui-testing does
tui-testing directs the authoring of headless terminal UI tests in warp_tui and warpui_core. These checks bypass real display servers: components render directly onto a cell grid, allowing assertions against deterministic text slices.
Shared element tests inside warpui_core use helpers like render_to_lines and with_paint_context. Composite elements require calling layout prior to render, because child dimensions remain empty without it. View-level tests in warp_tui run under App::test and require an Appearance::mock() singleton from warp_core whenever themes must resolve.
Execution relies on Cargo tools via cargo nextest run -p warp_tui or cargo nextest run -p warpui_core. Enabling the element library during tests requires the --features tui flag.
What it helps with
- test headless TUI elements without spinning up a display server
- verify cell attributes, text colors, and cursor coordinates in memory
- simulate keyboard and scroll actions through
dispatch_event - wire up mock appearance models for themed terminal views
Example prompts for the agent
- Write a unit test for a new composite TUI element in warpui_core using render_to_lines
- Implement a view test in crates/warp_tui that asserts cursor position after keystroke events
- Show how to run a single TUI test using cargo nextest filtering
How to install tui-testing
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-testing -a claude-code2Manually: put the files in place
~/.claude/skills/tui-testing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tui-testing/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-testing -a codex2Manually: put the files in place
.agents/skills/tui-testing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-testing -a cursor2Manually: put the files in place
.cursor/skills/tui-testing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp .agents/skills/tui-testing2Manually: put the files in place
.github/skills/tui-testing/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-testing -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/tui-testingManually: put the files in place
.devin/skills/tui-testing/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tui-testing
How to install tui-testing in Claude Code?
Run npx skills add dominikmartn/harp --skill tui-testing -a claude-code in your terminal.
What does tui-testing do?
It guides writing fast unit tests for Warp's terminal frontend by capturing output directly into text buffers.
What is required to run tui-testing suites?
You need cargo-nextest and must pass the --features tui flag when testing crates that gate TUI elements behind cargo features.