VibeTunnel is an innovative tool designed to transform any web browser into a fully functional terminal interface, enabling users to command and monitor their AI agents and terminal sessions remotely. Its primary purpose is to eliminate the friction and complexity associated with traditional remote terminal access, such as SSH key management, port forwarding, and firewall configuration. VibeTunnel is particularly useful for developers and AI practitioners who need to check on long-running processes, monitor AI agents, or collaborate with colleagues from anywhere, using any device.
The repository offers multiple installation options to suit different environments. Mac users benefit from a native macOS app, optimized for Apple Silicon (M1+), which integrates seamlessly into the menu bar and provides automatic updates. For Linux and headless systems, VibeTunnel can be installed as a global npm package, offering the same server and web UI functionality without the macOS-specific features. The tool requires Node.js 22.12+ and is not yet supported on Windows.
VibeTunnel’s core functionality revolves around the `vt` command, a smart wrapper that forwards terminal sessions through the VibeTunnel server. This command supports shell alias resolution, session title management, and intelligent detection of the best available implementation (macOS app or npm package). Users can run any command, open interactive shells, and leverage custom aliases directly from the browser interface. The dashboard, accessible at http://localhost:4020, displays all active terminal sessions, with real-time activity indicators showing which sessions are active or idle.
A standout feature is Git Follow Mode, which synchronizes the main repository checkout with the branch being worked on in a Git worktree. This enables seamless workflows for agent-assisted development, allowing IDEs and servers to automatically follow branch switches without manual intervention. VibeTunnel installs lightweight Git hooks to detect branch changes and manages synchronization intelligently, pausing when uncommitted changes are present to prevent data loss.
VibeTunnel’s architecture comprises three main components: a native macOS menu bar app (written in Swift), a high-performance Node.js server (in TypeScript), and a modern web frontend built with Lit components and ghostty-web. The server runs as a standalone executable, ensuring minimal resource usage and excellent performance.
Remote access is a key focus, with several secure options available. Tailscale integration allows users to create encrypted peer-to-peer VPN networks, offering both private (tailnet-only) and public (internet-exposed via Funnel) access modes with automatic HTTPS support. ngrok and Cloudflare Quick Tunnel provide alternative methods for exposing the VibeTunnel server to the public internet, each with their own benefits such as SSL certificates and request inspection.
Security is prioritized through multiple authentication modes, including system authentication (macOS and Linux), environment variable authentication, SSH key authentication, and local bypass (for development only). The macOS app supports these modes and offers configuration via its settings. Best practices are recommended, such as always using authentication when binding to network interfaces and employing HTTPS in production environments.
Additional features include session recording in asciinema format, smart keyboard handling for quick session switching, shell alias support, and terminal title management. The tool is mobile-ready, with a responsive web interface and a developing native iOS app. VibeTunnel is licensed under MIT and welcomes contributions from the community, providing extensive documentation and support channels. Overall, VibeTunnel offers a robust, user-friendly solution for remote terminal access and agent management, tailored for modern development workflows.
