VibeTunnel终端管理

技能简介

VibeTunnel 是一个通过 REST API 管理终端会话的工具，支持创建、列出、监控和控制可在 Web 仪表板中查看的终端会话。

能做什么

• 创建新的终端会话，指定命令、工作目录和终端尺寸
• 列出所有会话并查看运行状态
• 向会话发送输入文本（包括执行命令）
• 调整会话的终端窗口大小
• 删除指定会话或清理已退出会话

使用说明

前置条件：需先启动 VibeTunnel 服务，默认地址为 http://localhost:8080，可通过 VT_URL 环境变量覆盖。

安装指令：

npm install -g vibetunnel

基本操作步骤：

1. 检查服务健康状态：

   curl -s ${VT_URL:-http://localhost:8080}/api/health | jq .

2. 创建会话（以 zsh 为例）：

   curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions \
     -H "Content-Type: application/json" \
     -d '{"command": ["zsh", "-l", "-i"], "name": "my-session", "workingDir": "/path/to/dir"}' | jq .

3. 发送命令到会话（注意包含 \n 执行）：

   curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions/<id>/input \
     -H "Content-Type: application/json" \
     -d '{"text": "ls -la\n"}' | jq .

4. 删除会话：

   curl -s -X DELETE ${VT_URL:-http://localhost:8080}/api/sessions/<id> | jq .

输入与输出

见下方输入与输出表格。

风险提示

• 需确保 VibeTunnel 服务已启动，否则所有 API 调用将失败
• 发送输入时若遗漏 \n，命令不会执行仅作为文本输入
• 直接操作终端会话可能导致运行中的任务中断
• 清理已退出会话前请确认无重要数据需要保留

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/basher83/vibetunnel/SKILL.md
来源类型：GitHub 仓库