Repolode
amantus-ai

amantus-ai/vibetunnel

Browser-based terminal access that lets you run, monitor and command shell sessions and AI coding agents from any device.

Stars
4,692
Forks
335
Open issues
5
Last commit
3 months ago

What is it?

VibeTunnel forwards terminal sessions from a host machine into a web dashboard, so you can watch long-running builds, tests or AI coding agents from a phone, tablet or another computer. The server runs on localhost port 4020 by default, and the `vt` command wraps any shell command so its output appears in the browser, with support for shell aliases and interactive shells.

The project ships as a native macOS menu bar app for Apple Silicon Macs and as an npm package (`vibetunnel`) for Linux, Docker and headless systems on Node.js 22.12 through 24.x. Remote access can be set up through Tailscale (private or Funnel-based public mode), ngrok, Cloudflare quick tunnels, Pinggy or Pangolin. Authentication options include system accounts, environment-variable credentials, Ed25519 SSH keys and a localhost bypass for development.

Additional features include Git Follow Mode, which keeps a main checkout in sync with the branch an agent switches to in a worktree, configurable terminal title modes, activity indicators and session recording in asciinema format. Windows is not yet supported.

Key features

  • 01Shows terminal sessions in any modern web browser with a dashboard of all sessions.
  • 02Wraps commands with the `vt` CLI, including shell alias and function resolution.
  • 03Provides a native macOS menu bar app and an npm package for Linux and headless hosts.
  • 04Offers several authentication modes, including system accounts, SSH keys and environment credentials.
  • 05Supports remote access via Tailscale, ngrok, Cloudflare, Pinggy and Pangolin.
  • 06Records sessions in asciinema format for later playback.

Use cases

  • Checking on a long-running build or test suite from a phone while away from the desk.
  • Monitoring AI coding agents such as Claude Code running on a development machine.
  • Sharing a live terminal session with a colleague without setting up SSH.
  • Running a terminal dashboard on a headless Linux server or Docker container.

Quick start

  1. 1

    Install the npm package globally

    npm install -g vibetunnel
  2. 2

    Or install the macOS app via Homebrew

    brew install --cask vibetunnel
  3. 3

    Run any command in the browser

    vt pnpm run dev
  4. 4

    Open the dashboard at localhost port 4020

Things to know

  • The native macOS app requires an Apple Silicon Mac (M1 or later); Intel Macs are not supported for it.
  • Windows is not yet supported.
  • The iOS app is a work in progress and not recommended for production use.

Topics

FAQ

What is vibetunnel?
Browser-based terminal access that lets you run, monitor and command shell sessions and AI coding agents from any device. VibeTunnel forwards terminal sessions from a host machine into a web dashboard, so you can watch long-running builds, tests or AI coding agents from a phone, tablet or another computer. The server runs on localhost port 4020 by default, and the `vt` command wraps any shell command so its output appears in the browser, with support for shell aliases and interactive shells.
Is vibetunnel free to use? What license does it have?
vibetunnel is open source under the MIT license. Check the license terms before using it in commercial products.
Is vibetunnel still maintained?
Updated within 6 months. The last commit to vibetunnel was on Aug 5, 2026.
What can I use vibetunnel for?
Checking on a long-running build or test suite from a phone while away from the desk. Monitoring AI coding agents such as Claude Code running on a development machine. Sharing a live terminal session with a colleague without setting up SSH. Running a terminal dashboard on a headless Linux server or Docker container.
How do I install vibetunnel?
Install the npm package globally: npm install -g vibetunnel Or install the macOS app via Homebrew: brew install --cask vibetunnel Run any command in the browser: vt pnpm run dev Open the dashboard at localhost port 4020
Where can I get vibetunnel?
The source code and installation instructions are on GitHub: https://github.com/amantus-ai/vibetunnel

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects