tuistory

Test and automate terminal applications with a Playwright-style API and CLI.

2|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/pi-ohm/pi-ohm --skill tuistory-pi-ohm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tuistory
Source: https://github.com/pi-ohm/pi-ohm/tree/main/.pi/skills/tuistory
Command: npx skills add https://github.com/pi-ohm/pi-ohm --skill tuistory-pi-ohm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the testing and automation of command-line interface (CLI) and terminal user interface (TUI) applications, which are often difficult to test with traditional methods.

Core Features & Use Cases

  • Playwright-like Testing: Write end-to-end tests for CLIs/TUIs using a familiar API with inline snapshots.
  • Terminal Automation: Programmatically interact with terminal applications, useful for scripting complex workflows or building agent UIs.
  • Screenshotting: Capture terminal output as images for documentation or sharing with users.
  • Use Case: Automatically test a new CLI tool by scripting user interactions, verifying output, and ensuring it behaves as expected across different scenarios.

Quick Start

Use the tuistory CLI to launch a new terminal session running the 'my-app' command.

Frequently Asked Questions about tuistory

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

FAQPage Schema
How do I write end-to-end tests for terminal and CLI applications?

End-to-end testing for terminal applications is done using a Playwright-style API to script user interactions, observe output, and verify expected behavior. It supports inline snapshots within test suites like Vitest.

What is the best way to automate TUI interaction for scripting workflows?

Automating TUI interaction is achieved through a dedicated CLI that enables direct shell interaction for scripting complex workflows or building agent UIs. You can launch terminal sessions running specific commands and programmatically interact with the application.

Can I capture terminal output as an image for documentation?

Yes, you can capture terminal output as screenshots. This feature allows you to generate images of your CLI or TUI output, which is useful for sharing visual results with users or including terminal states in project documentation.

Does this Playwright-style API work with my existing Vitest test suite?

Yes, the API is designed for programmatic use within existing test suites like Vitest. You can import the testing functions to launch terminal sessions, automate interactions, and use inline snapshots to assert expected terminal output directly in your tests.

Why is testing command-line interfaces difficult with traditional testing methods?

Testing command-line interfaces is difficult with traditional methods because they lack a DOM and rely on continuous terminal output streams. A Playwright-style API solves this by allowing programmatic interaction and observation of terminal states without relying on standard web automation techniques.