Skip to main content
skill CX Codex

gui-integration-test — Claude Code skill: Warp GUI integration tests

gui-integration-test is a Claude Code skill that writes and debugs integration tests for Warp's GUI desktop app on the Builder/TestStep harness. Runs when a test is added or fixed.

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 gui-integration-test -a claude-code
Open on GitHub

What gui-integration-test does

Each test boots a real Warp instance with a throwaway home directory, feeds it synthetic UI and terminal events, then polls assertions until they pass or time out. Scope is the GUI desktop front-end (app/ crate on WarpUI); headless TUI work belongs to the separate TUI skills.

A test starts as pub fn name() -> Builder in a module under crates/integration/src/test/, gets exported from test.rs, and is registered with register_test! in crates/integration/src/bin/integration.rs. The outer harness in crates/integration/tests/common/mod.rs shells out to that binary and retries the run up to 10 times when it exits with the rerun code.

Being present under src/test/ does not make a test run: it also has to be listed in ui_tests.rs or shell_integration_tests.rs, otherwise cargo nextest never picks it up. The harness swaps HOME for a temp directory and writes minimal rc files, so real dotfiles and saved Warp settings stay out of the run.

What it helps with

  • scaffold a new integration test under crates/integration/src/test/
  • trace a failing test that exits with the rerun code
  • wire a test into nextest and the manual runner
  • check shell integration across bash, zsh and fish
  • move deterministic logic out of a slow app-boot test into a unit test

Example prompts for the agent

  • Add an integration test for moving focus between panes and register it in ui_tests.rs.
  • The test in shell_integration_tests.rs keeps exiting with the rerun code, find out why and fix it.
  • Check that the new test shows up in both cargo nextest and the manual runner.

How to install gui-integration-test

1Skills CLI (Vercel)

npx skills add dominikmartn/harp --skill gui-integration-test -a claude-code

2Manually: put the files in place

~/.claude/skills/gui-integration-test/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gui-integration-test/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about gui-integration-test

How do I install gui-integration-test in Claude Code?

Run npx skills add dominikmartn/harp --skill gui-integration-test -a claude-code. The skill file lands at ~/.claude/skills/gui-integration-test/SKILL.md.

What does gui-integration-test do?

It covers writing and debugging integration tests for Warp's GUI desktop app: where the test function lives, how to register it, and how it reaches the manual runner and nextest.

Does the skill work for the TUI?

No, it targets the GUI desktop front-end (app/ on WarpUI). Headless TUI code in crates/warp_tui has its own skills: tui-ui-guidelines, tui-testing and tui-verify-change.

Similar skills

All skills for Testing and QA →

From the same set62

The whole set →
gui-create-launch-modal gui-create-launch-modal is a Claude Code skill for building a one-time launch modal in Warp’s GUI. A feature flag controls the startup display for each user. CX Codex +1 ★ 720repo stars changelog-draft changelog-draft is a Claude Code skill that turns pull requests merged between two release tags into a changelog draft, keeping explicit CHANGELOG markers and sorting the rest into categories. CX Codex +1 ★ 720repo stars oz-platform oz-platform is a Claude Code skill for running and inspecting Oz cloud agents through Warp's REST API and CLI. It also handles schedules and agent environments. CX Codex +1 ★ 720repo stars rust-unit-tests rust-unit-tests is a Claude Code skill that writes and improves Rust unit tests within the codebase. It assists when handling data transformations or fixing reproducible bugs. CX Codex +1 ★ 720repo stars gui-settings-ui gui-settings-ui is a Claude Code skill for editing Warp GUI settings pages. It keeps widget visibility and settings search aligned with the page structure. CX Codex +1 ★ 720repo stars tui-verify-change tui-verify-change is a Claude Code skill that runs Warp’s headless TUI and reads its rendered screen after UI, input, or behavior changes. CX Codex +1 ★ 720repo stars logging-and-error-reporting Logging-and-error-reporting is a Claude Code skill that standardizes log levels and Sentry error reporting. It runs during development or code review to ensure consistent error handling. CX Codex +1 ★ 720repo stars gui-onboarding-verification-skill gui-onboarding-verification-skill is a Claude Code skill that checks Warp’s first-run setup on Linux. It captures screenshots for logged-in and logged-out onboarding flows. CX Codex +1 ★ 720repo stars

Project sponsors

Companies that keep this analytics open