{"id":"bb9c9f25-e688-4582-8db7-6e7311921497","entityType":"agent","slug":"cybertheory-clrun","name":"clrun","canonicalUrl":"https://xpersona.co/agent/cybertheory-clrun","canonicalPath":"/agent/cybertheory-clrun","generatedAt":"2026-04-17T04:30:37.814Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Run and control interactive CLI sessions for AI agents. 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. --- name: clrun description: Run and control interactive CLI sessions for AI agents. 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. license: MIT metadata: author: cybertheory version: \"1.0.1\" c","descriptionLabel":"Technical summary","evidenceSummary":"Published capability contract available. No trust telemetry is available yet. 2 GitHub stars reported by the source. Last updated 4/15/2026.","installCommand":"git clone https://github.com/cybertheory/clrun.git","sourceUrl":"https://github.com/cybertheory/clrun","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/cybertheory/clrun","kind":"source"}],"safetyScore":89,"overallRank":44.3,"popularityScore":12,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Run and control interactive CLI sessions for AI agents. Handles TUI prompts (select lists, checkboxes, confirms), persistent shell state, and long-running proce"},"coverage":{"evidence":{"source":"capability-contract + public-profile","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:41:39.341Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"run","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":2,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"run","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:run|supported|profile"}},"adoption":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"stars":2,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":"2 GitHub stars"},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-03-01T06:02:07.487Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-03-01T06:02:07.487Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T06:02:07.487Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"capability-contract","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:41:39.341Z","emptyReason":null},"installCommand":"git clone https://github.com/cybertheory/clrun.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"ready","authModes":["api_key"],"requires":["openclew","lang:typescript"],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":"https://github.com/cybertheory/clrun#input","outputSchemaRef":"https://github.com/cybertheory/clrun#output","dataRegion":"global","contractUpdatedAt":"2026-02-24T19:41:39.341Z","sourceUpdatedAt":"2026-02-24T19:41:39.341Z","freshnessSeconds":4438138},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/snapshot","contractUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/contract","trustUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/trust"},"curlExamples":["curl -s \"https://xpersona.co/api/v1/agents/cybertheory-clrun/snapshot\"","curl -s \"https://xpersona.co/api/v1/agents/cybertheory-clrun/contract\"","curl -s \"https://xpersona.co/api/v1/agents/cybertheory-clrun/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-04-17T04:30:37.814Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/dossier","snapshotUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/snapshot","contractUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/contract","trustUrl":"https://xpersona.co/api/v1/agents/cybertheory-clrun/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":[],"safeUseWhen":["Contract is available with explicit auth and schema references.","Trust confidence is not low and verification freshness is acceptable."],"riskFlags":["trust_data_unavailable"],"operationalConfidence":"medium"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: clrun\ndescription: Run and control interactive CLI sessions for AI agents. 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.\nlicense: MIT\nmetadata:\n  author: cybertheory\n  version: \"1.0.1\"\ncompatibility: Requires Node.js >= 18. Works on macOS, Linux, and Windows.\n---\n\n# clrun — The Interactive CLI for AI Agents\n\nNo more `--yes` flags or command retries. `clrun` gives you full control over interactive terminal sessions with structured YAML responses.\n\n## Install\n\n```bash\nnpm install -g clrun\n```\n\n## Core Commands\n\n| Action | Command |\n|--------|---------|\n| Run a command | `clrun <command>` |\n| Send text + Enter | `clrun <id> \"text\"` |\n| Send keystrokes | `clrun key <id> down enter` |\n| Toggle checkbox | `clrun key <id> space` |\n| Accept default | `clrun key <id> enter` |\n| View output | `clrun tail <id>` |\n| Check sessions | `clrun status` |\n| Kill session | `clrun kill <id>` |\n| Interrupt | `clrun key <id> ctrl-c` |\n\n## Two Input Modes\n\n**Text input** — sends text followed by Enter:\n```bash\nclrun <id> \"my-project-name\"    # Type and press Enter\nclrun <id> \"\"                    # Just press Enter\n```\n\n**Keystroke input** — sends raw keys for TUI navigation:\n```bash\nclrun key <id> down down enter           # Select 3rd item in list\nclrun key <id> space down space enter    # Toggle checkboxes 1 and 2\nclrun key <id> enter                      # Accept default\n```\n\nAvailable 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`\n\n## Identifying Prompt Types\n\nWhen you `tail` a session, identify the prompt type to choose the right input:\n\n| You see | Type | Action |\n|---------|------|--------|\n| `◆ Name: │ default` | Text input | `clrun <id> \"value\"` or `clrun key <id> enter` |\n| `● Opt1 ○ Opt2 ○ Opt3` | Single-select | `clrun key <id> down... enter` |\n| `◻ Opt1 ◻ Opt2 ◻ Opt3` | Multi-select | `clrun key <id> space down... enter` |\n| `● Yes / ○ No` | Confirm | `clrun key <id> enter` or `right enter` |\n| `(y/n)` | Simple confirm | `clrun <id> \"y\"` or `clrun <id> \"n\"` |\n| `name: (default)` | Readline | `clrun <id> \"value\"` or `clrun <id> \"\"` |\n\n## Select List Navigation\n\nCount items from the top. First item is highlighted by default. To select item N, send N-1 `down` presses then `enter`.\n\n```\n◆  Select a framework:\n│  ● Vanilla       ← 0 downs\n│  ○ Vue           ← 1 down\n│  ○ React         ← 2 downs\n│  ○ Svelte        ← 3 downs\n```\n\n```bash\nclrun key <id> down down enter   # Selects React\n```\n\n## Multi-Select Pattern\n\nPlan a sequence of `space` (toggle) and `down` (skip) from top to bottom, ending with `enter`:\n\n```bash\n# Select items 1, 3, and 4 from a list of 5:\nclrun key <id> space down down space down space enter\n#              item1 skip  skip  item3 item4 confirm\n```\n\n## Reading Responses\n\nAll responses are structured YAML. Key fields:\n\n- **`terminal_id`** — store this for all subsequent calls\n- **`output`** — cleaned terminal output (ANSI stripped)\n- **`status`** — `running`, `suspended`, `exited`, `killed`, `detached`\n- **`hints`** — exact commands you can run next (copy-pasteable)\n- **`warnings`** — detected issues with input or output\n\n## Workflow Pattern\n\n```\n1. START    →  clrun <command>               → get terminal_id\n2. OBSERVE  →  clrun tail <id>               → read output, identify prompt\n3. INTERACT →  clrun <id> \"text\" / clrun key → respond to prompt\n4. REPEAT   →  steps 2-3 until done\n5. CLEANUP  →  clrun kill <id>               → if needed\n```\n\n## Shell Variable Quoting\n\nUse single quotes to prevent your shell from expanding `$` variables:\n\n```bash\nclrun <id> 'echo $MY_VAR'          # Correct\nclrun <id> \"echo $MY_VAR\"          # Wrong — expanded before clrun sees it\n```\n\n## Session Persistence\n\n- Environment variables persist within a session\n- Sessions auto-suspend after 5 min idle (env and cwd saved)\n- Sending input to a suspended session auto-restores it\n- No pre-check needed — just send input\n\nSee [references/tui-patterns.md](references/tui-patterns.md) for complete real-world examples.\n","readmeExcerpt":"--- name: clrun description: Run and control interactive CLI sessions for AI agents. 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. license: MIT metadata: author: cybertheory version: \"1.0.1\" c","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npm install -g clrun"},{"language":"bash","snippet":"clrun <id> \"my-project-name\"    # Type and press Enter\nclrun <id> \"\"                    # Just press Enter"},{"language":"bash","snippet":"clrun key <id> down down enter           # Select 3rd item in list\nclrun key <id> space down space enter    # Toggle checkboxes 1 and 2\nclrun key <id> enter                      # Accept default"},{"language":"text","snippet":"◆  Select a framework:\n│  ● Vanilla       ← 0 downs\n│  ○ Vue           ← 1 down\n│  ○ React         ← 2 downs\n│  ○ Svelte        ← 3 downs"},{"language":"bash","snippet":"clrun key <id> down down enter   # Selects React"},{"language":"bash","snippet":"# Select items 1, 3, and 4 from a list of 5:\nclrun key <id> space down down space down space enter\n#              item1 skip  skip  item3 item4 confirm"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Run and control interactive CLI sessions for AI agents. 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. --- name: clrun description: Run and control interactive CLI sessions for AI agents. 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. license: MIT metadata: author: cybertheory version: \"1.0.1\" c","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":393,"uniquenessScore":64,"reasons":[]}},"media":{"evidence":{"source":"agent-media-assets","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"primaryImageUrl":null,"mediaAssetCount":1,"assets":[{"url":"https://github.com/cybertheory/references/tui-patterns.md","title":null,"caption":null,"altText":"references/tui-patterns.md","assetKind":"ARTIFACT","sourcePageUrl":"https://github.com/cybertheory/clrun"}],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-04-17T04:30:37.814Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}