Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dominikmartn/harp --skill tui-testing -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/tui-testing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tui-testing/

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.

Similar skills

All skills for Testing and QA →

From the same set62

The whole set →
factory-deferred-repositories factory-deferred-repositories is a Claude Code skill that checks out repositories from a deferred task list. It verifies access and an unused target before fetching one on demand. CX Codex +1 ★ 720repo stars add-telemetry add-telemetry is a Claude Code skill for adding telemetry events to the Warp codebase. Runs when instrumenting new features, debugging issues, or tracking product metrics. CX Codex +1 ★ 720repo stars oz-child-agent-orchestration oz-child-agent-orchestration is a Claude Code skill for coordinating a child run with its lead through the Oz CLI. The Oz harness system prompt controls when it runs. CX Codex +1 ★ 720repo stars gui-reproduce-bug-report-local gui-reproduce-bug-report-local is a Claude Code skill that reproduces Warp GUI bugs without authentication. It targets visual layout and onboarding issues on matching Linux releases. CX Codex +1 ★ 720repo stars tui-ui-guidelines The tui-ui-guidelines skill for Claude Code provides standards for building Warp TUI interfaces. Install this before starting any TUI implementation task. CX Codex +1 ★ 720repo stars tui-migrate-setup tui-migrate-setup is a Warp Agent CLI skill that moves eligible settings and global MCP definitions from Warp GUI. It also identifies data already shared between the two environments. CX Codex +1 ★ 720repo stars triage-vulnerabilities triage-vulnerabilities is a Claude Code skill that pulls vulnerabilities from Dependabot, GCP Artifact Registry, Docker Scout and Linear, then fixes them one at a time. It fires on a request to check CVEs. CX Codex +1 ★ 720repo stars tab-configs tab-configs is a Claude Code skill that documents Warp tab config schemas and checks. It activates while creating or editing tab-config TOML files. CX Codex +1 ★ 720repo stars

Project sponsors

Companies that keep this analytics open