control-cli — Claude Code skill: what it does, how to install
Builds a local harness to drive, test, and profile interactive CLI or TUI tools. Catches UI regressions, memory leaks, and hangs without third-party services.
npx skills add cursor/plugins --skill control-cli -a claude-codeWhat control-cli does
The skill drives interactive terminal apps inside isolated local sessions instead of relying on manual testing. It checks the project for existing test harnesses or scripts first. When none exist, it creates a temporary test loop using tmux or a short PTY script in Python or Node. Actions like keypresses, Ctrl-C interrupts, and terminal resizing happen step by step.
For profiling startup bottlenecks or memory growth, the workflow connects Node or Bun runtime inspectors directly. The harness avoids arbitrary sleep calls, waiting instead for concrete output patterns before continuing. Temporary test scripts live in /tmp and get purged when the run finishes, preventing leftover background sessions from lingering.
What it helps with
- reproduce interactive CLI bugs with deterministic keystroke sequences
- profile startup regressions and heap usage in terminal utilities
- verify terminal layout behavior during window resizing and abort signals
- capture clean screen transcripts for pull requests and bug fixes
Example prompts for the agent
- Run a tmux test session to check how the CLI handles Ctrl-C interrupts
- Profile memory usage during interactive prompt navigation
- Capture terminal output step by step to reproduce the layout crash
How to install control-cli
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill control-cli -a claude-code2Manually: put the files in place
~/.claude/skills/control-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/control-cli/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill control-cli -a codex2Manually: put the files in place
.agents/skills/control-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill control-cli -a cursor2Manually: put the files in place
.cursor/skills/control-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cursor/plugins control-cli2Manually: put the files in place
.github/skills/control-cli/SKILL.md1Skills CLI (Vercel)
npx skills add cursor/plugins --skill control-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/cursor/plugins --path cursor-team-kit/skills/control-cliManually: put the files in place
.devin/skills/control-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cursor/plugins --skill control-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set18
The whole set →Similar
Questions about control-cli
How to install control-cli in Claude Code?
Run npx skills add cursor/plugins --skill control-cli -a claude-code in your terminal.
What does control-cli do?
It creates local test harnesses using tmux or PTY scripts to exercise interactive command-line programs and capture output deterministically.
What dependencies does control-cli require?
It relies on existing repository test scripts, a local tmux binary, or Python with the built-in pty module. Node or Bun runtime inspectors are used when profiling JavaScript CLIs.