skills.rest
ElbertePlinio
ElbertePlinioCOMMUNITY
Explore all skills by this author →
Website𝕏@ElbertePlinioGitHub

tuistory

Automate terminal TUI applications via a virtual pseudo-terminal backend.

Updated Jul 13, 2026
Search Tags:#regression testing#session recording#terminal automation#cli testing#tuistory#tui automation#virtual pty
One-click install
npx skills add https://github.com/ElbertePlinio/dotfiles --skill tuistory-elberteplinio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tuistory
Source: https://github.com/ElbertePlinio/dotfiles/tree/main/private_dot_factory/plugins/marketplaces/factory-plugins/plugins/droid-control/skills/tuistory
Command: npx skills add https://github.com/ElbertePlinio/dotfiles --skill tuistory-elberteplinio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of reliably automating terminal text user interface (TUI) applications, eliminating flaky manual interaction and the need to handle low-level terminal keyboard encoding for most common automation scenarios.

Core Features & Use Cases

  • Virtual PTY TUI Automation: Interact with terminal TUI applications via a virtual pseudo-terminal, with built-in commands for typing text, sending key presses, waiting for specific output patterns, and capturing clean text snapshots of the screen.
  • Session Recording & Comparison: Record full terminal interactions as asciinema .cast files for demos and regression testing, including support for before/after comparisons of TUI behavior across different code versions.
  • Use Case: For example, a developer can use this Skill to automate regression tests for a CLI tool's interactive TUI, record the full interaction flow, and compare output snapshots between a baseline and a new code version to catch UI regressions.

Quick Start

Use the tuistory skill to automate a TUI workflow for your target CLI application, capture a text snapshot of the final screen state, and save a recording of the interaction as an asciinema cast file.

Frequently Asked Questions about tuistory

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

FAQPage Schema
How do I automate terminal TUI workflows without manual keyboard input?▼

Virtual PTY terminal automation drives interactive CLI applications through a virtual pseudo-terminal backend, eliminating manual interaction and low-level keyboard encoding. You can type text, send key presses, wait for output patterns, and capture clean text snapshots of the screen programmatically.

Can I record terminal sessions as asciinema cast files for regression testing?▼

Yes, terminal session recording captures full interactive CLI tool interactions as asciinema .cast files for demos and regression testing. You can perform before/after comparisons of TUI behavior across different code versions to catch UI regressions.

Do I need tmux or asciinema installed to use virtual PTY for CLI testing?▼

You need the tuistory global npm package for core virtual PTY TUI automation. Tmux is an optional dependency providing scrollback buffer support, and asciinema is optional for recording terminal interactions as shareable .cast files.

What's the best way to capture clean text snapshots of terminal output for validation?▼

Clean text snapshotting of terminal output is handled by interacting with the TUI via a virtual PTY backend, which captures the screen state without manual interaction. This allows you to validate final screen text snapshots during routine TUI automation and regression testing.

Does virtual PTY regression testing work for interactive CLI tools with complex text user interfaces?▼

Virtual PTY regression testing applies to routine TUI automation tasks for interactive CLI tools, handling complex text user interfaces by sending key presses and waiting for specific output patterns. It captures text snapshots to validate TUI behavior across different code versions.

Related Skills

Explore More Software Engineering Skills→
tilework-techtilework-tech
166

TUI Puppeteering with tmux

Automate isolated TUI testing workflows using tmux-based scripts.

Official
Advanced
microsoftmicrosoft
6.2k

cli-e2e-testing

Automates Aspire CLI end-to-end tests with Hex1b terminal scripting and deterministic prompts.

Official
Advanced
terrylicaterrylica
62

asciinema-recorder

Generate asciinema terminal recording commands with workspace-based filenames.

Community
Advanced
alexei-ledalexei-led
35

asking-codex

Delegate coding tasks to an OpenAI Codex agent via the Codex CLI.

Community
Basic