explaingit

amantus-ai/vibetunnel

4,493TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A Mac menu bar app and npm package that lets you view and control all your terminal sessions from any web browser on any device, without needing SSH or extra configuration.

Mindmap

mindmap
  root((vibetunnel))
    What It Does
      Browser terminal access
      No SSH needed
      Monitor AI agents
    Platforms
      Mac app menu bar
      npm for Linux
      iOS native app
    Key Features
      vt command wrapper
      Session recording
      Git follow mode
    Remote Access
      Local only mode
      Tailscale support
      ngrok integration
    Setup
      Mac app download
      npm install
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Monitor a long-running AI coding agent on your Mac from your phone while away from your desk

USE CASE 2

Access and control your development terminal from a tablet or another computer via a browser

USE CASE 3

Record terminal sessions in a standard format for playback or sharing later

USE CASE 4

Set up secure remote terminal access over the internet using Tailscale or ngrok integration

Tech stack

TypeScriptNode.jsElectron

Getting it running

Difficulty · easy Time to first run · 5min

Mac version requires Apple Silicon (M1 or newer), Windows is not yet supported.

Use freely for any purpose, including commercial projects, as long as you keep the copyright notice.

In plain English

VibeTunnel is a tool that lets you access your computer's terminal from any web browser, on any device. Instead of using SSH (a technical method for remote computer access that requires configuration and keys), you install VibeTunnel on your machine, start it, and then visit a local web address to see and control all your open terminal sessions from a phone, tablet, or another computer's browser. The main version is a Mac application for Apple Silicon machines (M1 and newer). It sits in your menu bar and runs a local server on your computer. An npm package version is also available for Linux, Intel Macs, and headless server environments. The tool does not yet support Windows. The core workflow involves a command called vt that you put in front of any terminal command you want to monitor or control through the browser. Running vt pnpm run dev or vt claude starts that process and makes it visible in the web dashboard. The dashboard shows which sessions are active or idle, and you can interact with them from any connected device. Features described in the README include a Git follow mode that automatically switches the terminal view when your code editor changes branches, session recording in a standard format for later playback, multiple authentication options (including a localhost-only mode and integration with Tailscale or ngrok for remote access over the internet), and keyboard shortcut handling with toggleable capture modes. There is also a native iOS app and a mobile-friendly web interface. The project is framed around monitoring AI coding tools like Claude Code and similar terminal-based agents while you are away from your main computer, though it works for any terminal session. It is open source under the MIT license. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
How do I install VibeTunnel on my Mac and set it up so I can watch a Claude Code session from my phone's browser?
Prompt 2
Using the vt command, how do I start my dev server so I can monitor and interact with it from a browser on another device?
Prompt 3
How do I configure VibeTunnel to be accessible over the internet securely using Tailscale instead of just on my local network?
Prompt 4
How does VibeTunnel's Git follow mode work, and how do I enable it to automatically switch the terminal view when my editor changes branches?
Open on GitHub → Explain another repo

← amantus-ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.