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…

Custom licenceAuto-check: notesDevelopment

Install Tui Test

skills CLI
$ npx skills add herald-email/herald-mail-app --skill tui-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install herald-email/herald-mail-app tui-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/herald-email/herald-mail-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tui-test .claude/skills/tui-test && rm -rf skills-src

Use ~/.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/

Facts

Skill name
tui-test
GitHub stars
144
Token cost
~3.1k tokens
SKILL.md length
1,346 words
Files
3 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

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…

  • Works in 3 steps: Build A Lightweight App Manifest → Set Up Repeatable Helpers → The Core Loop
  • Development work in your project
  • SKILL.md covers Deliverables, Non-Negotiables, Step 1: Build A Lightweight… and Step 2: Set Up Repeatable…, plus 6 more sections
  • Runs Shell scripts from its folder; calls make, go and rg

What it does

Tui Test is an agent skill from 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 previews.

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `screenshot.sh` and `scripts/resize_cycle.sh`).

It sits in Development. 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

  • Development work in your project

Example prompts

  • “/tui-test”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Glob, Grep, Edit, Agent, TodoWrite

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Build A Lightweight App Manifest
  2. Set Up Repeatable Helpers
  3. The Core Loop

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:

    • Bash
    • Read
    • Write
    • Glob
    • Grep
    • Edit
    • Agent
    • TodoWrite

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • make
    • go
    • rg

    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.1k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 1,346 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

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); the scripts in this folder 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,346 words (~3,061 tokens).

“Use this skill to audit terminal UIs through tmux. It is generic by default, with a ready-made Herald profile for this repo.”

— opening of SKILL.md by herald-email, Custom licence
name
tui-test
allowed-tools
Bash, Read, Write, Glob, Grep, Edit, Agent, TodoWrite
disable-model-invocation
true
argument-hint
[app: herald | generic] [focus: full | hotkeys | resize | timeline | compose | cleanup | contacts | ai]

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts) in .agents/skills/tui-test of herald-email/herald-mail-app.

  • SKILL.md
  • screenshot.sh
  • scripts/resize_cycle.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.

Tui Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tui Test this skillherald-email/herald-mail-app144—~3.1kAutomated safety check: NotesCustom licence
Agent Feature ReproductionQwenLM/qwen-code28k—~1.5kAutomated safety check: PassApache-2.0
Git History Bug Auditben-manes/caffeine18k—~3.3kAutomated safety check: PassApache-2.0
Tuicragavra/tuicr3.3k—~3.2kAutomated safety check: PassMIT
Using Tmux For Interactive Commandsobra/superpowers-lab4302 repos~1.3kAutomated safety check: PassMIT
Qwen Code Memory Leak DebuggerQwenLM/qwen-code28k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Reproduces a feature from Codex or Claude Code in Qwen Code by running the reference agent under capture, reading the traces, then implementing matching behavior.

    28k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Git History Bug Audit

    ben-manes/caffeine

    Audits a module by walking its git history commit by commit, tracking unresolved issues forward, and reporting the ones that survive to HEAD as findings.

    18k GitHub stars~3.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Tuicr

    agavra/tuicr

    Use tuicr's review CLI to read and add comments in active TUI review sessions, and launch tuicr in cmux, tmux, Zellij, or Herdr when a user needs an interactive review pane.

    3.3k GitHub stars~3.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • A skill your agent uses when you need to run interactive CLI tools (vim, git rebase -i, Python REPL, etc.) that require real-time input/output - provides tmux-based approach for controlling…

    430 GitHub starsUsed in 2 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Walks through capturing and comparing V8 heap snapshots to find memory leaks in the Qwen Code Node.js CLI, using tmux and the chrome-devtools CLI.

    28k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Revdiff

    umputun/revdiff

    Review diffs, files, and documents with inline annotations in a TUI overlay, or answer questions about revdiff usage, configuration, themes, and keybindings.

    920 GitHub stars~5.5k tokensUpdated yesterday
    DevelopmentAuto-check: notes

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…

    144 GitHub stars~4.9k tokensUpdated 2 mo ago
    Auto-check passed
  • 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…

    144 GitHub stars~448 tokensUpdated 2 mo ago
    Auto-check passed
  • 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…

    144 GitHub stars~881 tokensUpdated 2 mo ago
    Auto-check passed
  • 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…

    144 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Release

    herald-email/herald-mail-app

    Herald beta release workflow for requests to cut, tag, publish, or repair a Herald release.

    144 GitHub stars~2.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Tui Test

    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.

    144 GitHub stars~3.5k tokensUpdated 2 mo ago
    Auto-check: notes

Works with

Categories

Questions about Tui Test

What does Tui Test do?

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…. Tui Test is an agent skill from 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 previews.

When should I use Tui Test?

Tui Test fits situations like: development work in your project.

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 (.agents/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 (.agents/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 (make, go and rg). 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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.1k tokens (SKILL.md is roughly 12k 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: Agent Feature Reproduction (QwenLM/qwen-code, 28k stars), Git History Bug Audit (ben-manes/caffeine, 18k stars), Tuicr (agavra/tuicr, 3.3k stars) and Using Tmux For Interactive Commands (obra/superpowers-lab, 430 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 144 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.