name: agent-cli-helper-skill
description: Run interactive CLI programs in isolated sessions, send keystrokes, capture screen output. Use for vim, nano, ssh, emacs, ipdb, and any terminal-based interactive applications. Keywords: terminal, interactive, tmux, shell, vim, ssh, emacs, debugger.
compatibility: Requires tmux installed on system
agent-cli-helper Skill
Use this skill when you need to interact with full-screen terminal applications like:
- Text editors: vim, nano, emacs
- Remote connections: ssh, telnet
- Debuggers: pdb, ipdb, gdb
- Any interactive CLI program
Quick Reference
| Command | Purpose |
|---|
agent-cli-helper run-command "<cmd>" | Start a program in a session |
agent-cli-helper send-keystrokes <session-id> "<keys>" | Send keystrokes to session with an Enter |
agent-cli-helper send-raw-keystrokes <session-id> "<keys>" | Send keystrokes to session without and enter |
| `agent-cli-helper finish-command | Clean up a session |
agent-cli-helper get-screen-capture <session-id> | Get current screen |
agent-cli-helper kill-session <session-id> | Kill a session |
agent-cli-helper list-sessions | List all sessions |
Session ID Format
Session IDs are derived from the command. Examples:
ssh fanon.local → ssh-fanon-localvim /tmp/file.txt → vim-tmp-filepython -m ipdb script.py → python-m-ipdb
Keystroke Syntax
^X → Ctrl+X\n → Enter\t → TabUp, Down, Left, Right → Arrow keysBSpace → BackspaceF1-F12 → Function keys
Error Handling
If a session already exists with the same name, you'll get a collision error. Use agent-cli-helper force-run-command to create a new session anyway.
Important Notes
- Always check the
<screen-capture> in the output to see program state
- Sessions persist until explicitly killed - don't forget to clean up
