clrun
Run and control interactive CLI sessions. Handles TUI prompts (select lists, checkboxes, confirms), persistent shell state, and long-running processes. Use when you need to execute terminal commands, respond to interactive prompts, navigate scaffolding wizards like create-vue or create-vite, or manage dev servers.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/cybertheory/clrunclrun — The Interactive CLI for AI Agents
Use clrun whenever you need to run commands that require interactive input,
TUI navigation, long-running processes, or deterministic execution control.
No more --yes flags or command retries.
When to Use clrun
- Interactive scaffolders — create-vue, create-vite, create-astro, npm init
- TUI tools with select lists, checkboxes, and confirm dialogs
- Long-running processes — dev servers, test suites, docker builds
- Stateful sessions — setting env vars, then querying them later
- Any command that prompts for user input
Quick Reference
| Action | Command |
|---|---|
| Run a command | clrun <command> |
| Send text + Enter | clrun <id> "text" |
| Send keystrokes | clrun key <id> down enter |
| Toggle checkbox | clrun key <id> space |
| Accept default | clrun key <id> enter |
| View latest output | clrun tail <id> or clrun <id> |
| Check all sessions | clrun status |
| Kill a session | clrun kill <id> |
| Interrupt (Ctrl+C) | clrun key <id> ctrl-c |
Two Input Modes
Text Input (clrun <id> "text")
Sends text followed by Enter. Use for:
- Typing text into prompts (project names, descriptions, etc.)
- Sending shell commands to the running session
- Responding to simple yes/no or readline-style prompts
clrun <id> "my-project-name" # Type text and press Enter
clrun <id> "" # Just press Enter (accept default for readline)
Keystroke Input (clrun key <id> <keys...>)
Sends raw keystrokes. Use for:
- Navigating select lists (
up,down,enter) - Toggling checkboxes (
space) - Accepting TUI defaults (
enter) - Switching Yes/No (
left,right) - Interrupting processes (
ctrl-c)
clrun key <id> down down enter # Select 3rd item in a list
clrun key <id> space down space enter # Toggle checkboxes 1 and 2, confirm
clrun key <id> enter # Accept default / confirm
Available keys:
up, down, left, right, enter, tab, escape, space,
backspace, delete, home, end, pageup, pagedown,
ctrl-c, ctrl-d, ctrl-z, ctrl-l, ctrl-a, ctrl-e, y, n
Identifying Prompt Types
When you tail a session and see a prompt, identify its type:
| You see | Type | Action |
|---|---|---|
◆ Project name: │ default | Text input | clrun <id> "name" or clrun key <id> enter |
● Option1 ○ Option2 ○ Option3 | Single-select | clrun key <id> down... enter |
◻ Option1 ◻ Option2 ◻ Option3 | Multi-select | clrun key <id> space down... enter |
● Yes / ○ No | Confirm | clrun key <id> enter or clrun key <id> right enter |
(y/n), [Y/n] | Simple confirm | clrun <id> "y" or clrun <id> "n" |
package name: (default) | Readline | clrun <id> "value" or clrun <id> "" |
Select List Navigation
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-cybertheory-clrun": {
"enabled": true,
"auto_update": true
}
}
}