# gui-integration-test

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/gui-integration-test/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gui-integration-test

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-integration-test -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gui-integration-test/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gui-integration-test/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-integration-test -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gui-integration-test/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-integration-test -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gui-integration-test/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp .agents/skills/gui-integration-test
```

2. **Manually: put the files in place**
- File: `.github/skills/gui-integration-test/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-integration-test -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/gui-integration-test
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gui-integration-test/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/gui-integration-test/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [integration-test-builder](https://affpapa.org/en/nevibecode/skills/integration-test-builder.md) — skill · 267 installs
- [integration-test-reviewer](https://affpapa.org/en/nevibecode/agents/integration-test-reviewer.md) — subagent · ★ 720 repo stars
- [run-rust-tests](https://affpapa.org/en/nevibecode/skills/run-rust-tests.md) — skill · ★ 6244 repo stars
- [132-java-testing-integration-testing](https://affpapa.org/en/nevibecode/skills/132-java-testing-integration-testing.md) — skill · 401 installs
- [testing-craft](https://affpapa.org/en/nevibecode/skills/testing-craft.md) — skill · 1200 installs
- [test-architect](https://affpapa.org/en/nevibecode/agents/test-architect.md) — subagent · ★ 1424 repo stars

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
