vibetunnel  by amantus-ai

Turn any browser into your terminal

created 2 months ago
2,010 stars

Top 22.0% 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

1 week ago

Responsiveness

1 day

Pull Requests (30d)
90
Issues (30d)
61
Star History
769 stars in the last 30 days

Explore Similar Projects

Starred by Shawn Wang Shawn Wang(Editor of Latent Space), Shizhe Diao Shizhe Diao(Research Scientist at NVIDIA; Author of LMFlow), and
2 more.

chatgpt-mac by vincelwt

0.0%
6k
Desktop app for quick-access ChatGPT
created 2 years ago
updated 1 year ago
Feedback? Help us improve.