CodexBar Live QA
steipete/CodexBar
Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.
Battle-test the Herald TUI — automated exploratory testing that captures screens, detects visual defects programmatically, and digs into anything suspicious.
Install Tui Test
$ npx skills add herald-email/herald-mail-app --skill tui-test -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install herald-email/herald-mail-app tui-test --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tui-test .claude/skills/tui-test && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "tui-test" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-test into .claude/skills/tui-test/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-test", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-testType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add herald-email/herald-mail-app --skill tui-test -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install herald-email/herald-mail-app tui-test --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/tui-test .agents/skills/tui-test && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tui-test" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-test into .agents/skills/tui-test/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-test", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add herald-email/herald-mail-app --skill tui-test -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install herald-email/herald-mail-app tui-test --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/tui-test .cursor/skills/tui-test && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tui-test" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-test into .cursor/skills/tui-test/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-test", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/herald-email/herald-mail-app.git --path .claude/skills/tui-test--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add herald-email/herald-mail-app --skill tui-test -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install herald-email/herald-mail-app tui-test --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/tui-test .gemini/skills/tui-test && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tui-test" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-test into .gemini/skills/tui-test/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-test", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install herald-email/herald-mail-app tui-testInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add herald-email/herald-mail-app --skill tui-test -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/tui-test .github/skills/tui-test && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tui-test" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-test into .github/skills/tui-test/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-test", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add herald-email/herald-mail-app --skill tui-test -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install herald-email/herald-mail-app tui-test --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/tui-test .opencode/skills/tui-test && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tui-test" agent skill from https://github.com/herald-email/herald-mail-app/tree/main/.claude/skills/tui-test into .opencode/skills/tui-test/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-test", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tui-test- GitHub stars
- 146
- Token cost
- ~3.5k tokens
- SKILL.md length
- 1,300 words
- Files
- 2
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Battle-test the Herald TUI — automated exploratory testing that captures screens, detects visual defects programmatically, and digs into anything suspicious.
- Works in 12 steps: Structural Integrity → Border Completeness → Column Alignment → …
- Tasks that involve QA and bug reports
- SKILL.md covers The Core Loop, How to Detect Defects in a…, Setup and Exploration Plan, plus 2 more sections
- Runs Shell scripts from its folder; calls go
What it does
Tui Test is an agent skill from herald-email/herald-mail-app. Battle-test the Herald TUI — automated exploratory testing that captures screens, detects visual defects programmatically, and digs into anything suspicious. Simulates prolonged real usage.
Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `screenshot.sh`).
It sits in Testing & QA, covering QA and bug reports. It works with tmux. The repository describes itself as: Herald is a terminal email client and inbox cleanup tool with IMAP, AI-assisted triage, MCP tools, and SSH/browser-friendly app modes.
When your agent uses it
- Tasks that involve QA and bug reports
Example prompts
- “/tui-test”
Requirements
- A Bash shell
- Pre-approved tools (allowed-tools): Bash, Read, Write, Glob, Grep, Edit, Agent, TodoWrite
Workflow steps
12 steps, taken from the step headings in SKILL.md.
- Structural Integrity
- Border Completeness
- Column Alignment
- Content Presence
- Layout at Different Sizes
- Hint Placement
- Baseline at 220x50
- Exercise Every Tab (still 220x50)
- Deep Dive — Repetition (pick the most complex tab first)
- The Resize Gauntlet (single session, no restart)
- Cross-Tab State
- Edge Cases
What it can do on your machine
Read from SKILL.md and the folder at commit b097c04. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
BashReadWriteGlobGrepEditAgentTodoWrite
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Shell), which the agent can run.
Shell commands in SKILL.md call:
go
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Tui Test loads about 3.5k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 1,300 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Bash, Read, Write, Glob, Grep, Edit, Agent, TodoWrite
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,300 words (~3,490 tokens).
“You are testing Herald, a terminal email client. Your job is to systematically USE the app via tmux, capture every screen, ANALYZE each capture for defects, and dig deeper into anything that looks wrong.”
- name
- tui-test
- allowed-tools
- Bash, Read, Write, Glob, Grep, Edit, Agent, TodoWrite
- disable-model-invocation
- true
- argument-hint
- [focus: full | stress | ai | contacts | timeline | cleanup | compose | navigation]
Files
SKILL.md and 1 other file in .claude/skills/tui-test of herald-email/herald-mail-app.
- SKILL.md
- screenshot.sh
Open the folder on GitHubat commit b097c04
Compare with similar skills
Tui Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Tui Test this skillherald-email/herald-mail-app | 146 | — | ~3.5k | Automated safety check: Notes | Custom licence | |
| CodexBar Live QAsteipete/CodexBar | 22k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Codex Plugin QAcode-yeongyu/oh-my-openagent | 70k | — | ~1.9k | Automated safety check: Pass | Custom licence | |
| OpenCode QA Toolkitcode-yeongyu/oh-my-openagent | 70k | — | ~2.9k | Automated safety check: Pass | Custom licence | |
| Senpi Agent QA Harnesscode-yeongyu/senpi | 474 | — | ~2.7k | Automated safety check: Notes | MIT | |
| tmux Real User TestingQwenLM/qwen-code | 28k | — | ~2.3k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Codex Plugin QA
code-yeongyu/oh-my-openagent
Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.
OpenCode QA Toolkit
code-yeongyu/oh-my-openagent
Tests the opencode coding agent itself: its CLI, server, plugin hooks and events, the terminal UI under tmux, and its SQLite session database, using tested helper scripts.
Senpi Agent QA Harness
code-yeongyu/senpi
Checks changes to the senpi coding agent by driving the real CLI from source in an isolated sandbox, over RPC, terminal UI, mock model and CLI smoke channels.
tmux Real User Testing
QwenLM/qwen-code
Drives Qwen Code in a real tmux session the way a user would and saves a readable step-by-step transcript of each screen for maintainers to review.
Verify Omnigent End-to-End
omnigent-ai/omnigent
Spins up an isolated Omnigent server, runner and mock model to prove a user-facing behavior or bug fix with recorded evidence instead of reasoning from code.
More from herald-email/herald-mail-app
Herald Autopilot
herald-email/herald-mail-app
A skill your agent uses when you want one repo-local Herald workflow to take a single bug, feature, or workflow improvement from intake through planning, isolated worktree setup, implementation…
Pre Release Test
herald-email/herald-mail-app
A skill your agent uses when preparing a Herald beta release, checking release readiness, or running broad deterministic integration gates across TUI themes, inline images, SSH, and MCP before…
Approve Gepa Changes
herald-email/herald-mail-app
A skill your agent uses when approving, rejecting, or marking implemented Herald GEPA pending approval items, including requests like "approve GEPA changes", "approve all pending GEPA", or approval…
Finish Development
herald-email/herald-mail-app
Herald-specific completion workflow for requests such as "finish-development", "nice" as a repo completion command, "wrap this branch", "fast merge", "fastpass", "quick merge", "fast mode", or…
Release
herald-email/herald-mail-app
Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release.
Tui Test
herald-email/herald-mail-app
Battle-test terminal UIs such as Herald via tmux and ttyd: reset states, compare visible hotkeys with actual behavior, capture ANSI/PNG evidence, run resize soaks, and verify terminal raster image…
Related
Works with
Categories
Questions about Tui Test
What does Tui Test do?
Battle-test the Herald TUI — automated exploratory testing that captures screens, detects visual defects programmatically, and digs into anything suspicious. Tui Test is an agent skill from herald-email/herald-mail-app. Battle-test the Herald TUI — automated exploratory testing that captures screens, detects visual defects programmatically, and digs into anything suspicious.
When should I use Tui Test?
Tui Test fits situations like: tasks that involve QA and bug reports.
How do I install Tui Test in Claude Code?
Run `npx skills add herald-email/herald-mail-app --skill tui-test -a claude-code`. Or copy the skill folder (.claude/skills/tui-test in herald-email/herald-mail-app) into .claude/skills/tui-test in your project. Claude Code loads it when a task matches its description.
How do I install Tui Test in Codex?
Run `npx skills add herald-email/herald-mail-app --skill tui-test -a codex`. Or copy the skill folder (.claude/skills/tui-test in herald-email/herald-mail-app) into .agents/skills/tui-test in your project. Codex loads it when a task matches its description.
Can I use Tui Test in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add herald-email/herald-mail-app --skill tui-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tui-test, .gemini/skills/tui-test, .github/skills/tui-test and .opencode/skills/tui-test in your project.
What does Tui Test need to run?
Going by SKILL.md and its folder, Tui Test needs a shell for the scripts in its folder and the command-line tools its instructions call (go). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Bash, Read, Write, Glob, Grep, Edit, Agent, TodoWrite.
Does Tui Test access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Tui Test safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Tui Test use?
Tui Test has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Tui Test use?
About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Tui Test?
Skills that share tags, products or a category with Tui Test: CodexBar Live QA (steipete/CodexBar, 22k stars), Codex Plugin QA (code-yeongyu/oh-my-openagent, 70k stars), OpenCode QA Toolkit (code-yeongyu/oh-my-openagent, 70k stars) and Senpi Agent QA Harness (code-yeongyu/senpi, 474 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Tui Test?
herald-email (a GitHub organization) maintains it in herald-email/herald-mail-app, which has 146 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on July 13, 2026.
Source: herald-email/herald-mail-app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.