A comprehensive tool for managing, monitoring, and controlling terminal sessions through the VibeTunnel REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install vibetunnel
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install vibetunnel using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is VibeTunnel?
VibeTunnel acts as a powerful management layer for terminal sessions, enabling developers to interact with shell processes through a standardized REST API. By leveraging this tool within the Openclaw Skills ecosystem, users can programmatically create, list, and control terminal instances that are instantly visible in the VibeTunnel web dashboard. It bridges the gap between automated script execution and interactive terminal environments, making it an essential component for developers who need to orchestrate complex CLI workflows.
VibeTunnel Use Cases
- Programmatically launching interactive CLI tools like Claude Code or tmux within a managed session environment.
- Monitoring the health and status of multiple active terminal sessions from a centralized web dashboard.
- Automating the cleanup of exited or orphaned terminal processes to maintain optimal system performance.
- Sending direct text input to running shells for remote orchestration and automation of interactive commands.
- Dynamically resizing terminal windows to accommodate specific output requirements or display constraints.
How VibeTunnel Works
- The skill establishes a connection with a running VibeTunnel server instance, defaulting to localhost:8080.
- It performs health checks and queries the session list to verify the state of the management environment.
- New terminal sessions are initialized by sending POST requests containing command arrays, working directory paths, and grid dimensions.
- Users can interact with existing sessions by sending raw text input or resize commands to the server.
- The skill manages the session lifecycle by tracking session IDs, allowing for specific sessions to be retrieved or deleted as needed.
VibeTunnel Setup
VibeTunnel requires Node.js and the jq utility for processing API responses. To begin using this in your Openclaw Skills workflow, install the package and ensure the server is active.
npm install -g vibetunnel
By default, the skill looks for the server at http://localhost:8080. You can override this by setting the appropriate environment variable:
export VT_URL="http://your-server-address:8080"
Verify the setup with a health check:
curl -s ${VT_URL}/api/health | jq .
VibeTunnel Data Schema & Taxonomy
The skill organizes session data and metadata through the following JSON schema to ensure compatibility with Openclaw Skills integrations:
| Property | Type | Description |
|---|---|---|
id |
String | Unique UUID for the terminal session |
name |
String | Custom display name for dashboard identification |
status |
String | Current process state (e.g., running, exited) |
command |
Array | The executable and arguments being run |
workingDir |
String | The directory context for the session |
cols |
Number | The character width of the terminal grid |
VibeTunnel Advanced Features
- Support for complex command arrays allowing the initialization of login shells with interactive flags.
- Batch session management capabilities, enabling the selection and deletion of processes based on status.
- Real-time input injection for automated interaction with software that typically requires manual keyboard input.
- Flexible environment configuration through VT_URL for seamless switching between local and remote tunnels.
- Precise terminal resizing to ensure output formatting remains consistent across different viewing environments.
SKILL.md
Loading
Related Openclaw Skills
DevTools Secrets
A comprehensive secrets management workflow integrating mise, fnox, and infisical to ensure secure environment variable injection and credential hygiene.
Blowfish Solana Token Launch
Automate the deployment of Solana tokens through the Blowfish Agent API with integrated Meteora Dynamic Bonding Curve support.
Supermetrics Marketing Data
A comprehensive integration allowing AI agents to programmatically fetch marketing performance data from over 100 platforms through a unified API.
Z.AI Web Search
A high-performance search skill for AI agents that returns structured, LLM-ready web data including summaries and metadata.
Pet Sitter Client Intake Form Generator
A specialized tool for pet care professionals to generate branded, fillable PDF client intake and onboarding forms with ease.
Conventional Commits
A skill that enforces the Conventional Commits specification for git messages to enable automated changelogs and semantic versioning.
Featured*
