termscope

Drive and inspect terminal applications programmatically for automated TUI testing.

18|1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/mwunsch/termscope --skill termscope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: termscope
Source: https://github.com/mwunsch/termscope/tree/main
Command: npx skills add https://github.com/mwunsch/termscope --skill termscope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drive and inspect terminal applications programmatically to enable automated testing, debugging, and visual validation of TUIs.

Core Features & Use Cases

  • Snapshot terminal state for debugging and regression testing.
  • Drive interactions via type, press, and wait_for_text, including a JSON-lines session protocol.
  • Use for CI validation, interactive CLI automation, and visual regression testing across sizes and formats.

Quick Start

Run termscope snapshot -- htop to capture the terminal state.

Frequently Asked Questions about termscope

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

FAQPage Schema
How do I automate terminal app testing for TUI visual regression?

Automate terminal app testing by programmatically driving interactions and capturing snapshots to detect visual regressions across multiple terminal sizes. You can use keyboard input, text search, and a JSON-lines session protocol for CI validation.

Can I capture terminal snapshots for debugging rendering issues in CLI applications?

Yes, you can capture terminal snapshots to debug rendering issues in CLI applications by running a snapshot command against your terminal program. This enables programmatic inspection of the terminal state for interactive workflows.

What is a JSON-lines session protocol for CLI testing automation?

A JSON-lines session protocol for CLI testing automation is a structured format used to drive terminal interactions by sending keyboard inputs and waiting for text. It enables programmatic control and inspection of terminal applications.

Does termscope support interactive CLI automation across different terminal sizes?

Yes, termscope supports interactive CLI automation across different terminal sizes for visual validation. You can drive interactions like typing and pressing keys, then capture snapshots to validate rendering at various dimensions.

How do I drive keyboard input and wait for text in automated TUI testing?

Drive keyboard input and wait for text in automated TUI testing by applying type, press, and wait_for_text operations. These commands enable programmatic interaction with terminal applications to automate testing workflows.

What is the best way to inspect terminal state during interactive CLI automation?

The best way to inspect terminal state during interactive CLI automation is to capture snapshots that record the current rendering output. This allows you to debug rendering issues and validate visual regressions programmatically.