Termscope

Drive and inspect terminal applications programmatically. Use for TUI testing, visual regression, debugging rendering issues, and automating interactive CLI tools. Provides snapshot capture, keyboard/text input, text search, and a JSON-lines session protocol.

19 stars 1 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add mwunsch/termscope --skill termscope

Manual install

git clone --depth 1 https://github.com/mwunsch/termscope.git /tmp/termscope
mkdir -p ~/.claude/skills
cp -r /tmp/termscope/. ~/.claude/skills/termscope

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# termscope

Drive and inspect terminal applications — Playwright for the terminal.

## Prerequisites

termscope must be installed and on $PATH. Verify:

    termscope --version

If not installed:

    curl -fsSL https://raw.githubusercontent.com/mwunsch/termscope/main/install.sh | sh

## When to use termscope

- Inspect the visual state of a TUI application
- Debug rendering issues by capturing terminal snapshots
- Run visual regression tests in CI
- Automate interactive terminal applications (fill prompts, navigate menus)
- Verify that a CLI tool produces expected output with styling

## One-shot mode

### Snapshot

Capture the terminal state of a command:

```bash
# Plain text (default) — best for reading in context
termscope snapshot -- htop

# JSON — structured data for programmatic processing
termscope snapshot --format json -- my-app

# With custom terminal size
termscope snapshot --cols 120 --rows 40 -- btop

# Write to file
termscope snapshot --format svg -o screenshot.svg -- my-tui
```

### Exec (linear sequence)

Chain actions left-to-right:

```bash
# Wait for prompt, type, press enter, snapshot
termscope exec \
  --wait-for-text "Search:" \
  --type "hello" \
  --press RET \
  --wait-idle 200 \
  --snapshot \
  -- my-tui

# Assert text is present (exit 0/1 for CI)
termscope exec --expect "Error" -- my-app
```

Exec flags are processed in order. Each flag is a step.

## Session mode (agent driving)

Start a persistent session:

Read the full skill on GitHub

Details

Skill name: termscope
Repository: mwunsch/termscope
License: MPL-2.0
Repo updated: 8 April 2026

FAQ

What does the Termscope skill do?

How do I install the Termscope skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add mwunsch/termscope --skill termscope. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Termscope popular?

It lives in mwunsch/termscope, which has 19 GitHub stars and 1 forks.

Related skills

Antigravity CLI

SafeMantella/claude-code-agy-CLI-skill

Delegate heavy, multi-step, or specialized tasks to Google's Antigravity CLI agents. Use when a task would benefit from: (1) deep multi-file codebase analysis across many files, (2) web research with Google Search grounding, (3) image generation or visual assets, (4) a second AI perspective for code review or architecture decisions, (5) specialized scientific/biology database queries (gnomAD, UniProt, PubMed, etc.), (6) long-running refactors that would exhaust your context window, (7) tasks requiring many sequential tool calls that would consume excessive tokens. Also use when the user explic

Software Development

Flow Brief

shaokeyibb/flow-brief

Produce a single-file HTML swimlane brief that walks a system, module, or upcoming feature past a non-specialist reader, with provenance badges that separate what is measured from what is merely intended. Use this whenever someone needs to explain how something works to people outside the team — a flow diagram, an architecture walkthrough, an onboarding page, a design-review handout, a 介绍图 or 泳道图 — and especially when they describe the need without naming a format: "explain this to my boss", "draw how the data moves", "something the new hire can read", "I have to present this next week".

Software Development

Design Style

yanliudesign/design-style-skill

Recommend and apply design styles from a curated library of 67 visual aesthetics. Use when the user wants to choose a design style for their project, get style recommendations, or apply a style's CSS/colors/fonts to their code.

Software Development

Fpga Hardware Design and Review Guide

cobbpeng/fpga-hardware-design-and-review-guide

Comprehensive FPGA hardware design guide based on real-world project experience. Covers pipeline architecture, timing optimization, SystemVerilog coding patterns, CDC handling, and practical debugging techniques. Use this skill when: (1) designing FPGA modules with timing constraints, (2) implementing video processing or data path designs, (3) optimizing for resource utilization and timing closure, (4) reviewing RTL code for hardware implementation, (5) debugging synthesis or implementation issues.

Software Development

Audit Flow

ArunJRK/audit-flow

Interactive system flow tracing across CODE, API, AUTH, DATA, NETWORK layers with SQLite persistence and Mermaid export. Use for security audits, compliance documentation, flow tracing, feature ideation, brainstorming, debugging, architecture reviews, or incident post-mortems. Triggers on audit, trace flow, document flow, security review, debug flow, brainstorm, architecture review, post-mortem, incident review.

Software Development

Clean Architecture

tokenaissance/clean-architecture

Clean Architecture practitioner's guide. Trigger when users ask about four-layer architecture, dependency direction & inversion (DIP), an entity directly depending on external SDKs, ORM/data access layer (Repository pattern) design, microservice decomposition, technology selection, over-engineering, or architecture refactoring. Covers business logic organization in Express/Next.js/Go/Spring projects, MongoDB→PostgreSQL migrate, REST→GraphQL migrate, third-party integration (Stripe/PayPal), Redis caching, and Kafka message queue evaluation. Evaluates architecture against Robert C. Martin's Clea

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.