VibeTunnel is a TypeScript-based application that transforms any web browser into a terminal interface, enabling users to control their machines and AI agents remotely from any device. The project is hosted at vt.sh and allows developers to access their Mac terminals through a browser without requiring complex SSH configurations or port forwarding setup.
The core functionality centers on proxying terminal sessions directly into a web browser, making it particularly useful for monitoring long-running processes, AI agents like Claude Code or ChatGPT, and collaborative terminal sharing. The application supports multiple installation methods including a native macOS app for Apple Silicon Macs, an npm package for Linux and headless systems, and Homebrew installation. The npm package works with Node.js versions 22.12 through 24.x and supports both Intel Macs and Linux systems, though Windows support is not yet available.
VibeTunnel's feature set includes browser-based terminal access with zero configuration requirements, real-time session activity indicators showing which terminals are active or idle, and Git Follow Mode that automatically tracks branch switching in your IDE. The application provides intelligent keyboard handling with toggleable capture modes, allowing quick session switching via keyboard shortcuts. Security is implemented through multiple authentication modes, localhost-only operation, or secure tunneling via Tailscale and ngrok. The platform includes session recording in asciinema format for later playback and offers a responsive web interface suitable for mobile devices, with a native iOS app in development.
According to GitGenius activity tracking, the repository shows a median issue and pull request response latency of 4.2 hours across 274 tracked items, with a mean latency of 386 hours. The most active issue labels are nightly-build, good first issue, and ci, each with 51 tracked instances. The primary contributor steipete has generated 885 events, followed by manmal with 31 events and badlogic with 14 events. The repository shares overlapping contributors with github/gh-aw, solo-io/gloo, and longhorn/longhorn.
The GitGenius classification system categorizes VibeTunnel within emotion recognition, audio analysis, speech processing, and machine learning domains, with specific focus on real-time inference, sentiment detection, voice classification, emotion AI, and audio sentiment analysis. This classification suggests the project incorporates audio processing and emotion detection capabilities alongside its core terminal functionality.
The architecture consists of three main components: a native Swift macOS menu bar application managing server lifecycle, a high-performance Node.js server written in TypeScript handling terminal sessions, and a modern web frontend using Lit components and ghostty-web. The server runs as a standalone Node.js executable with embedded modules, optimized for Apple Silicon with ARM64-only binaries.
Remote access is facilitated through Tailscale integration, which creates secure peer-to-peer VPN networks between devices. VibeTunnel supports both Private Mode for secure HTTPS access within Tailscale networks and Public Mode for broader accessibility. The application includes shell alias support, ensuring custom aliases and shell functions work automatically across sessions. The project maintains comprehensive documentation at docs.vibetunnel.sh and actively engages with users through Discord and Twitter communities.
