TUI Puppeteering with tmux

Automate isolated TUI testing workflows using tmux-based scripts.

166|11|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/tilework-tech/nori-cli --skill tui-puppeteering-with-tmux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TUI Puppeteering with tmux
Source: https://github.com/tilework-tech/nori-cli/tree/main/.claude/skills/tui-puppeteering-with-tmux
Command: npx skills add https://github.com/tilework-tech/nori-cli --skill tui-puppeteering-with-tmux

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, and includes scripts (resource) components.

What problem does it solve?

This Skill automates isolated TUI testing workflows using bundled tmux-based scripts. It enables deterministic interaction and output capture for terminal UI applications in a self-contained environment.

Core Features & Use Cases

  • Isolated TUI sessions: Create deterministic environments that do not affect the user's real sessions.
  • Scripted test flows: Use a sequence of tui-start, tui-assert, tui-send, tui-capture, and tui-stop to validate UI behavior.
  • Use Case: QA engineers can script a full login and dashboard navigation test across different TUI apps and capture logs for failure analysis.

Quick Start

Start a test by invoking the bundled scripts in order: tui-start <session> "<command>"; then use tui-assert to verify output, tui-send to feed input, and tui-stop to clean up.

Frequently Asked Questions about TUI Puppeteering with tmux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate TUI testing for CLI applications?

Automate TUI testing by running bundled tmux scripts in sequence: tui-start <session> "<command>" to launch, tui-send to feed input, tui-assert to verify output, tui-capture to grab logs, and tui-stop to clean up the environment.

How do I run deterministic shell scripts to test terminal UI behavior?

Run deterministic shell scripts by creating isolated tmux sessions that prevent interference with real user sessions. This ensures scripted test flows validate UI behavior reliably and capture logs for failure analysis without side effects.

Does this TUI automation approach work with tmux?

Yes, this TUI automation approach works directly with tmux as its core dependency. It utilizes bundled scripts to manage tmux sessions, allowing you to start, send inputs, assert outputs, and stop isolated terminal UI tests.

Can I capture and verify terminal UI state in an isolated environment?

Yes, you can capture and verify terminal UI state in an isolated environment using the tui-capture and tui-assert scripts. This setup enables QA engineers to validate UI behavior and collect logs for failure analysis safely.

What is the best way to script a full login and dashboard navigation test in a TUI?

The best way to script a TUI login and dashboard navigation test is using the bundled sequence of tui-start, tui-send, tui-assert, and tui-stop scripts. This creates a deterministic, self-contained environment for validating CLI applications.