vibetunnel

---
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](https://github.com/AugmentedMomentum/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
```bash
curl -s ${VT_URL:-http://localhost:8080}/api/health | jq .
```

## List Sessions
```bash
curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq .
```

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

## Create Session
```bash
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
```bash
curl -s ${VT_URL:-http://localhost:8080}/api/sessions/<id> | jq .
```

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

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

Note: include `\n` to execute the command.

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

## Examples

**Launch Claude Code session:**
```bash
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:**
```bash
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:**
```bash
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 |