How do I install the Terminal Emulator skill?

Run npx skillmds@latest add gabrielmoreira/terminal-emulator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Terminal Emulator safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Terminal Emulator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Terminal Emulator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Terminal Emulator?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Terminal Emulator by gabrielmoreira

Name: Terminal Emulator
Rating: 4.2 (5 reviews)
Author: gabrielmoreira

Terminal Emulator

Test interactive CLI/TUI applications using @microsoft/tui-test. Use when you need to test CLI tools with interactive prompts, TUI rendering, arrow key navigation, or any command that requires a TTY. Triggers include "test CLI", "test TUI", "run interactively", "automate terminal input", "simulate user input in terminal".

gabrielmoreira Updated Sep 9, 2026 17 repo stars

File contents

Testing Interactive CLI / TUI with @microsoft/tui-test

Playwright-like API for terminals. Real PTY per test. Made by Microsoft.

GitHub: https://github.com/microsoft/tui-test
npm: @microsoft/tui-test

Install

yarn add -D @microsoft/tui-test

Usage

import { test, expect } from '@microsoft/tui-test';

test.use({ program: { file: 'node', args: ['./my-cli.js'] } });

test('selects option and proceeds', async ({ terminal }) => {
    await expect(terminal.getByText('Select an option')).toBeVisible();
    await terminal.write('\x1B[B');  // Arrow Down
    await terminal.submit();          // Enter
    await expect(terminal.getByText('Option 2 selected')).toBeVisible();
});

test('matches snapshot', async ({ terminal }) => {
    await expect(terminal).toMatchSnapshot();
});

API

// Navigation
await terminal.write('\x1B[A');    // Arrow Up
await terminal.write('\x1B[B');    // Arrow Down
await terminal.write('\x1B[C');    // Arrow Right
await terminal.write('\x1B[D');    // Arrow Left
await terminal.submit();           // Enter
await terminal.write('\t');        // Tab
await terminal.write('\x03');      // Ctrl+C
await terminal.write('\x1B');      // Escape
await terminal.write('\x7F');      // Backspace
await terminal.write('hello');     // Type text

// Assertions
await expect(terminal.getByText('pattern')).toBeVisible();
await expect(terminal.getByText('pattern', { full: true })).toBeVisible();
await expect(terminal).toMatchSnapshot();

// Reading
const content = terminal.content;  // Full terminal content as string

Running

npx tui-test                       # Run all tests
npx tui-test --update-snapshots    # Update snapshots
npx tui-test my-test.ts            # Run specific test

Reference

Used by VS Code terminal team
Real PTY isolation per test (no mocking)
Auto-waits for terminal renders
Cross-platform (macOS, Linux, Windows)
Snapshot testing built-in

---name: terminal-emulatordescription: Test interactive CLI/TUI applications using @microsoft/tui-test. Use when you need to test CLI tools with interactive prompts, TUI rendering, arrow key navigation, or any command that requires a TTY. Triggers include "test CLI", "test TUI", "run interactively", "automate terminal input", "simulate user input in terminal".--- # Testing Interactive CLI / TUI with @microsoft/tui-test Playwright-like API for terminals. Real PTY per test. Made by Microsoft. - **GitHub**: https://github.com/microsoft/tui-test - **npm**: `@microsoft/tui-test` ## Install ```bash yarn add -D @microsoft/tui-test ``` ## Usage ```typescript import { test, expect } from '@microsoft/tui-test'; test.use({ program: { file: 'node', args: ['./my-cli.js'] } }); test('selects option and proceeds', async ({ terminal }) => { await expect(terminal.getByText('Select an option')).toBeVisible(); await terminal.write('\x1B[B'); // Arrow Down await terminal.submit(); // Enter await expect(terminal.getByText('Option 2 selected')).toBeVisible(); }); test('matches snapshot', async ({ terminal }) => { await expect(terminal).toMatchSnapshot(); }); ``` ## API ```typescript // Navigation await terminal.write('\x1B[A'); // Arrow Up await terminal.write('\x1B[B'); // Arrow Down await terminal.write('\x1B[C'); // Arrow Right await terminal.write('\x1B[D'); // Arrow Left await terminal.submit(); // Enter await terminal.write('\t'); // Tab await terminal.write('\x03'); // Ctrl+C await terminal.write('\x1B'); // Escape await terminal.write('\x7F'); // Backspace await terminal.write('hello'); // Type text // Assertions await expect(terminal.getByText('pattern')).toBeVisible(); await expect(terminal.getByText('pattern', { full: true })).toBeVisible(); await expect(terminal).toMatchSnapshot(); // Reading const content = terminal.content; // Full terminal content as string ``` ## Running ```bash npx tui-test # Run all tests npx tui-test --update-snapshots # Update snapshots npx tui-test my-test.ts # Run specific test ``` ## Reference - Used by VS Code terminal team - Real PTY isolation per test (no mocking) - Auto-waits for terminal renders - Cross-platform (macOS, Linux, Windows) - Snapshot testing built-in

Frequently asked questions