A native macOS terminal built on libghostty, with vertical tabs, agent-aware notifications and a scriptable CLI for running AI coding agents in parallel.
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
Install the npm package globally
npm install -g vibetunnel - 2
Or install the macOS app via Homebrew
brew install --cask vibetunnel - 3
Run any command in the browser
vt pnpm run dev - 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
A minimal Rust-built statusline for Claude Code showing model, Git state, workspace, and context window usage in the terminal.
A native macOS terminal workspace with projects, tabs, split panes, a Git-aware file tree, and browser panes.
A macOS terminal app for running and monitoring multiple coding agents, with sessions kept alive by a daemon and an iPhone companion.
A CLI and template catalog of ready-to-use agents, commands, settings, hooks and MCP integrations for configuring Claude Code.
A Claude Code plugin that adds a live status line showing context usage, rate limits, active tools, running agents, and todo progress.