tuistory

Automate terminal UI interaction and testing in headless environments.

65.9k|7.1k|Updated Jul 6, 2024
One-click install
npx skills add https://github.com/cline/cline --skill tuistory-cline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tuistory
Source: https://github.com/cline/cline/tree/main/.cline/skills/tuistory
Command: npx skills add https://github.com/cline/cline --skill tuistory-cline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tuistory.

What problem does it solve?

This skill solves the challenge of testing and automating interactive terminal-based applications (TUIs) in headless environments where traditional display-based automation tools fail.

Core Features & Use Cases

  • Headless TUI Interaction: Drive terminal applications like the Cline CLI without needing a physical display or terminal emulator.
  • Reactive Automation: Use wait-based synchronization instead of brittle sleep timers to ensure commands execute only when the UI is ready.
  • Evidence Capture: Generate text snapshots and styled PNG screenshots of terminal states for debugging or documentation.
  • Use Case: Automate the end-to-end testing of the Cline CLI by launching an isolated session, navigating through settings, and verifying the output state without manual intervention.

Quick Start

Use the tuistory skill to launch a named terminal session for the Cline CLI and wait for the chat prompt to appear.

Frequently Asked Questions about tuistory

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

FAQPage Schema
How do I automate TUI testing in a headless environment?

Headless TUI testing automates interactive terminal applications by managing PTY sessions and capturing output streams without a physical display. It uses reactive wait-based synchronization to ensure commands execute only when the UI is ready, preventing brittle test failures.

What is the best way to test CLI tools without sleep timers?

Reactive waiting for CLI testing synchronizes command execution with actual UI readiness instead of arbitrary sleep timers. It interacts with isolated PTY sessions to drive terminal applications and verify output states reliably without timing failures.

Can I capture terminal screenshots during automated CLI testing?

Yes, you can capture terminal screenshots during automated CLI testing by generating styled PNG images and text snapshots of terminal states. This evidence capture provides visual output for debugging and documenting interactive terminal sessions.

Do I need a compatible terminal environment to run end-to-end CLI tests?

Yes, a compatible terminal environment and the tuistory library are required to execute commands and capture output streams for end-to-end CLI tests. The framework manages isolated PTY sessions within this environment to automate interaction and observation.

Why does traditional display-based automation fail for terminal applications?

Traditional display-based automation fails for terminal applications in headless environments because there is no physical display or terminal emulator to interact with. PTY session management bypasses this limitation by directly handling input and output streams.