vibetunnel  by amantus-ai

Turn any browser into your terminal

Created 5 months ago
2,475 stars

Top 18.6% on SourcePulse

GitHubView on GitHub
Project Summary

VibeTunnel transforms any browser into a remote terminal for managing AI agents and development workflows, targeting developers and AI practitioners who need on-the-go access to their command line. It offers a zero-friction alternative to SSH for accessing and controlling terminal sessions from any device.

How It Works

VibeTunnel comprises a native macOS menu bar app, a high-performance Node.js server, and a web frontend built with Lit and xterm.js. It proxies terminal sessions into the browser, enabling real-time interaction. Key features include dynamic terminal titles for activity tracking, Git follow mode for synchronizing worktrees, and robust authentication options. The vt command-line wrapper intelligently forwards commands, supporting shell aliases and session management.

Quick Start & Requirements

  • macOS App: Requires Apple Silicon (M1+). Install via direct download or Homebrew (brew install --cask vibetunnel).
  • npm Package: For Linux and headless systems. Install via npm install -g vibetunnel. Requires Node.js 20+.
  • Usage: Launch the app/server, then use vt <command> (e.g., vt pnpm run dev). Access the dashboard at http://localhost:4020.
  • Docs: Documentation

Highlighted Details

  • Git Follow Mode: Automatically syncs your main repository checkout with active Git worktrees, keeping IDEs and servers updated without manual intervention.
  • AI Agent Friendly: Optimized for monitoring AI tools like Claude and ChatGPT with dynamic title updates showing real-time activity.
  • Remote Access: Supports secure access via Tailscale or ngrok, alongside local network and Cloudflare Quick Tunnel options.
  • Session Recording: All terminal sessions are recorded in asciinema format for later playback.

Maintenance & Community

  • Community: Active Discord server for discussion and support.
  • Development: Open to contributions, with a clear contributing guide.
  • Support: Donations are accepted via Polar.

Licensing & Compatibility

  • License: MIT License. Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

  • Intel Macs are not supported for the native macOS app.
  • Windows is not yet supported.
  • The iOS app is still in development and not recommended for production use.
  • Initial Git repository scanning may trigger macOS permission prompts for protected folders.
Health Check
Last Commit

5 days ago

Responsiveness

1 day

Pull Requests (30d)
3
Issues (30d)
0
Star History
69 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.