test-cli

Automate end-to-end CLI testing with tmux sessions and output capture.

1|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/eli0shin/envoy --skill test-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-cli
Source: https://github.com/eli0shin/envoy/tree/main/.claude/skills/test-cli
Command: npx skills add https://github.com/eli0shin/envoy --skill test-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, node, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a repeatable, shell-based testing workflow for interactive CLI applications, including tmux-based sessions, so you can validate behavior, capture outputs, and automate regression tests without manual guessing.

Core Features & Use Cases

  • tmux-based testing sessions for CLI apps
  • Send prompts to the CLI character-by-character to simulate typing
  • Capture outputs with tmux to verify results
  • Helper scripts provide end-to-end testing workflows

Quick Start

Start a test session, send prompts, and capture results using the helper scripts in this Skill's scripts directory.

Frequently Asked Questions about test-cli

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

FAQPage Schema
How do I test an interactive CLI application end-to-end?

End-to-end CLI testing automates validation of interactive command-line applications by orchestrating tmux sessions, sending character-by-character prompts, capturing outputs, and verifying behavior without manual interaction. This Skill provides helper scripts to simulate realistic typing, submit prompts, and verify results in tmux-controlled terminals.

Can I automate testing for TUI and OpenTUI-based interfaces?

Yes, this Skill supports testing of terminal user interface (TUI) components and OpenTUI-based interfaces by automating tmux session management, sending interactive prompts, and capturing terminal outputs to verify application behavior.

What's the best way to capture CLI output during automated tests?

Use tmux-based session capture to record terminal outputs while sending prompts to your CLI application. This Skill provides helper scripts that manage tmux sessions and extract outputs for verification and regression testing.

How do I simulate typing in an interactive CLI test?

Simulate realistic typing by sending prompts character-by-character through tmux sessions. This Skill's helper scripts handle prompt submission and output capture, enabling automated testing of interactive CLI behavior.

Does this work with CLIs that require multiple Ctrl+C to exit?

Yes, this Skill includes specialized exit handling for CLIs requiring two Ctrl+C signals to terminate. The helper scripts manage session control and cleanup for complex exit scenarios.

What do I need to set up before running CLI tests with this Skill?

Before testing, ensure tmux and Node.js are installed on your system. Helper scripts are stored under .claude/skills/test-cli/scripts and managed through start-cli-test.sh for session orchestration and test workflow automation.