# Testing

> Guide for testing and verifying code changes in this TUI application. Use this skill after making ANY code changes to main.go or main.md to verify they work correctly. Use when this capability is needed.

- Skill: `tomevault-io/testing-37` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/testing-37`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/testing-37/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/testing-37

---


# Testing

This skill helps you create and run tests for terminal user interface (TUI) applications.

## When to use this skill

Use this skill:

- **After making ANY code changes** to verify they work correctly
- When modifying UI elements, menus, or display logic
- When changing application behavior or adding features
- To ensure existing functionality as specified in `main.md` and `README.md` is not broken

## Starting the application

- Run `scripts/run --test` where the user would normally run `github-brain`
  - `scripts/run --test pull` equivalently runs `github-brain pull`
  - `scripts/run --test mcp` equivalently runs `github-brain mcp`
  - The `--test` flag runs `go vet` before building to catch issues early
- Ensure `.env` files is configured to use the `github-brain-test` organization
- Use GitHub MCP to add new issue/PRs/discussions as needed for testing
- Simulate user input: Send key presses, control combinations, or specific commands to the running application.
- Capture and analyze screen output: The testing tool captures the terminal display (or buffer) at specific moments in time.
- Make assertions: Verify that the screen content matches the expected output (e.g., checking if specific text is present at certain coordinates or if the cursor position is correct).

---
> Source: [wham/github-brain](https://github.com/wham/github-brain) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-20 -->

