🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

VibeTunnel

by @basher83

Manage VibeTunnel terminal sessions. Create, list, monitor, and control terminal sessions visible in the VibeTunnel web dashboard.

Versionv1.0.0
Downloads2,481
TERMINAL
clawhub install vibetunnel

πŸ“– About This Skill


name: vibetunnel description: Manage VibeTunnel terminal sessions. Create, list, monitor, and control terminal sessions visible in the VibeTunnel web dashboard. homepage: https://github.com/AugmentedMomentum/vibetunnel metadata: {"clawdbot":{"emoji":"πŸ–₯️","requires":{"bins":["vibetunnel","curl","jq"]},"primaryEnv":"VT_URL","install":[{"id":"vibetunnel","kind":"node","package":"vibetunnel","bins":["vibetunnel"],"label":"Install VibeTunnel (npm)"}]}}

VibeTunnel

Manage VibeTunnel terminal sessions via REST API. Create, list, monitor, and control sessions visible in the web dashboard.

Setup

VibeTunnel must be running. Default: http://localhost:8080. Override with VT_URL env var.

Health Check

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

List Sessions

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

Compact view:

curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq -r '.[] | "\(.status | if . == "running" then "●" else "β—‹" end) \(.name) [\(.id | .[0:8])]"'

Create Session

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 .

Parameters:

  • command: array β€” command + args (default: ["zsh", "-l", "-i"])
  • name: string β€” display name
  • workingDir: string β€” working directory
  • cols: number β€” terminal width (default: 120)
  • rows: number β€” terminal height (default: 30)
  • Get Session

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

    Delete Session

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

    Send Input

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

    Note: include \n to execute the command.

    Resize Session

    curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions//resize \
      -H "Content-Type: application/json" \
      -d '{"cols": 150, "rows": 40}' | jq .
    

    Examples

    Launch Claude Code session:

    curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions \
      -H "Content-Type: application/json" \
      -d '{"command": ["claude"], "name": "claude-code", "workingDir": "~/repos/my-project"}' | jq .
    

    Launch tmux session:

    curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions \
      -H "Content-Type: application/json" \
      -d '{"command": ["tmux", "new", "-A", "-s", "work"], "name": "tmux-work"}' | jq .
    

    Clean up exited sessions:

    curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq -r '.[] | select(.status == "exited") | .id' | \
      xargs -I {} curl -s -X DELETE ${VT_URL:-http://localhost:8080}/api/sessions/{}
    

    Environment Variables

    | Variable | Default | Description | |----------|---------|-------------| | VT_URL | http://localhost:8080 | VibeTunnel server URL |

    πŸ’‘ Examples

    Launch Claude Code session:

    curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions \
      -H "Content-Type: application/json" \
      -d '{"command": ["claude"], "name": "claude-code", "workingDir": "~/repos/my-project"}' | jq .
    

    Launch tmux session:

    curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions \
      -H "Content-Type: application/json" \
      -d '{"command": ["tmux", "new", "-A", "-s", "work"], "name": "tmux-work"}' | jq .
    

    Clean up exited sessions:

    curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq -r '.[] | select(.status == "exited") | .id' | \
      xargs -I {} curl -s -X DELETE ${VT_URL:-http://localhost:8080}/api/sessions/{}
    

    βš™οΈ Configuration

    VibeTunnel must be running. Default: http://localhost:8080. Override with VT_URL env var.