Skip to main content
For remote access to your Schaltwerk sessions, we recommend VibeTunnel. It integrates seamlessly with Schaltwerk’s command prefix feature—just set vt as your prefix and all agent sessions become accessible from any browser, including your phone.

​
How It Works

VibeTunnel provides a vt command wrapper that forwards terminal sessions to a web dashboard. When combined with Schaltwerk’s command prefix feature:
  1. Each agent session is wrapped with vt
  2. VibeTunnel captures the terminal output
  3. You can view all sessions at http://localhost:4020
  4. With tunneling (Tailscale, ngrok, etc.), access from anywhere

​
Setup

1

Install VibeTunnel

macOS (Recommended):
brew install --cask vibetunnel
npm (Linux/Headless):
npm install -g vibetunnel
2

Start VibeTunnel

macOS App: Open VibeTunnel from Applications. It runs in the menu bar.npm: Run vibetunnel to start the server.
3

Configure Schaltwerk

Set the command prefix to vt in Settings → Terminal → Agent Command PrefixSee Terminal Configuration for details.
4

Start a session

Create or start any session in Schaltwerk. The agent will automatically be wrapped with VibeTunnel.
5

Access the dashboard

Open http://localhost:4020 to see all your agent sessions in the browser.

​
Remote Access Options

To access your sessions from other devices, you’ll need to expose the VibeTunnel dashboard. See the VibeTunnel documentation for details on:
  • Tailscale - Access via your private Tailscale network
  • ngrok - Create a public tunnel with ngrok http 4020
  • Cloudflare Tunnel - Use Cloudflare’s free tunnels
  • Local Network - Access via your machine’s IP address

​
Troubleshooting

  • Ensure VibeTunnel is running (check menu bar on macOS)
  • Verify the prefix is set to vt exactly in Schaltwerk settings
  • Restart the agent session after setting the prefix
  • Verify vt command is available: run which vt in terminal
  • Check Schaltwerk logs for error messages

​
Resources

VibeTunnel Documentation

Full documentation, features, and remote access setup