Turn any browser into your Mac terminal. VibeTunnel proxies your terminals right into the browser, so you can vibe-code anywhere.
Ever wanted to check on your AI agents while you're away? Need to monitor that long-running build from your phone? Want to share a terminal session with a colleague without complex SSH setups? VibeTunnel makes it happen with zero friction.
"We wanted something that just works" - That's exactly what we built.
VibeTunnel was born from a simple frustration: checking on AI agents remotely was way too complicated. During an intense coding session, we decided to solve this once and for all. The result? A tool that makes terminal access as easy as opening a web page.
Read the full story: VibeTunnel: Turn Any Browser Into Your Mac Terminal
- π Browser-Based Access - Control your Mac terminal from any device with a web browser
- π Zero Configuration - No SSH keys, no port forwarding, no complexity
- π€ AI Agent Friendly - Perfect for monitoring Claude Code, ChatGPT, or any terminal-based AI tools
- π Secure by Design - Password protection, localhost-only mode, or secure tunneling via Tailscale/ngrok
- π± Mobile Ready - Check your terminals from your phone, tablet, or any computer
- π¬ Session Recording - All sessions are recorded in asciinema format for later playback
Download VibeTunnel and drag it to your Applications folder.
VibeTunnel lives in your menu bar. Click the icon to start the server.
Prefix any command with vt to make it accessible in your browser:
# Monitor AI agents
vt claude
# Run development servers
vt npm run dev
# Watch long-running processes
vt python train_model.py
# Or just open a shell
vt --shellVisit http://localhost:4020 to see all your terminal sessions in the browser.
Monitor and control AI coding assistants like Claude Code remotely. Perfect for checking on agent progress while you're away from your desk.
vt claude --dangerously-skip-permissionsAccess your development environment from anywhere. No more "I need to check something on my work machine" moments.
vt code .
vt npm run devKeep an eye on system resources, logs, or long-running processes from any device.
vt htop
vt tail -f /var/log/system.logShare terminal sessions with colleagues or students in real-time through a simple web link.
- Install Tailscale on your Mac and remote device
- Access VibeTunnel at
http://[your-mac-name]:4020from anywhere on your Tailnet
- Add your ngrok auth token in VibeTunnel settings
- Enable ngrok tunneling
- Share the generated URL for remote access
- Set a dashboard password in settings
- Switch to "Network" mode
- Access via
http://[your-mac-ip]:4020
# Claude-specific shortcuts
vt --claude # Auto-locate and run Claude
vt --claude-yolo # Run Claude with dangerous permissions
# Shell options
vt --shell # Launch interactive shell
vt -i # Short form for --shell
# Direct execution (bypasses shell aliases)
vt -S ls -la # Execute without shell wrapperAccess settings through the menu bar icon:
- Server Port: Change the default port (4020)
- Launch at Login: Start VibeTunnel automatically
- Show in Dock: Toggle between menu bar only or dock icon
- Server Mode: Switch between Rust (default) or Swift backend
VibeTunnel is built with a modern, secure architecture:
- Native macOS app written in Swift/SwiftUI
- High-performance Rust server for terminal management
- Web interface with real-time terminal rendering
- Secure tunneling via Tailscale or ngrok
For technical details, see ARCHITECTURE.md.
# Clone the repository
git clone https://github.com/amantus-ai/vibetunnel.git
cd vibetunnel
# Build the Rust server
cd tty-fwd && cargo build --release && cd ..
# Build the web frontend
cd web && npm install && npm run build && cd ..
# Open in Xcode
open VibeTunnel.xcodeprojCreated with β€οΈ by:
- @badlogic - Mario Zechner
- @mitsuhiko - Armin Ronacher
- @steipete - Peter Steinberger
We welcome contributions! Please see our Contributing Guide for details.
VibeTunnel is open source software licensed under the MIT License. See LICENSE for details.
Ready to vibe? Download VibeTunnel and start tunneling!