Pre-release version

✨ Major Features

Push Notifications (#475)

• Native push notifications for terminal events - get notified when commands complete, sessions start/end, or errors occur
• Customizable notification types: Session exits, command completion (>3s), command errors, terminal bell, Claude AI turn notifications
• Smart Claude detection: Automatically identifies Claude CLI sessions and tracks when Claude finishes responding
• Complete overhaul of the notification system with reliable push notifications for session events
• Test notification feature now works seamlessly between web frontend and Mac app

Git Worktree Management & Follow Mode (#452)

• Full worktree support: Create, manage, and delete Git worktrees directly from VibeTunnel
• VibeTunnel intelligently follows Git worktrees instead of just branches, perfect for developers using worktrees for parallel development
• When you switch branches in your editor/IDE, VibeTunnel automatically switches to the corresponding worktree terminal session
• The vt follow command works contextually - run it from either your main repository or a worktree to set up appropriate tracking

Comprehensive CJK Input Support (#480)

• Full support for CJK input methods with proper IME (Input Method Editor) integration
• Fixed input duplication issues that affected Asian language users
• Improved Z-index management to ensure IME candidates display correctly above terminal content

Terminal Multiplexer Integration (#460)

• Full integration with tmux, Zellij, and GNU Screen terminal multiplexers for persistent sessions
• Create, list, and attach to tmux/Zellij/Screen sessions directly from VibeTunnel interface
• Sessions persist across VibeTunnel restarts - never lose your work

Quick Session Switching

• Use Cmd+1...9 (Mac) or Ctrl+1...9 (Linux) to instantly switch between sessions when keyboard capture is active
• Cmd/Ctrl+0 switches to the 10th session

🐛 Bug Fixes

• Enhanced VT command reliability with self-healing capabilities
• Fixed menu bar icon not appearing on app launch
• Enhanced Tailscale integration with automatic authentication
• Improved notification system reliability
• Fixed blinking cursor issue in binary terminal mode
• Completely redesigned keyboard handling for iOS devices

👥 Contributors

First-time contributors: @jblwilliams, @lox, @diegopetrucci

Additional contributors: @hjanuschka, @fal3, @hewigovens

Pre-release version

✨ Major Features

Customizable Quick Start Commands (#436)

• Quick Start commands are now fully customizable - previously hardcoded buttons can be edited
• Add your own commands with custom names and emoji (e.g., "✨ claude" or "▶️ dev server")
• Drag & drop reordering with smooth animations in macOS settings
• Inline editing without popup dialogs
• Reset to defaults button when you want the original set back
• File-based persistence in ~/.vibetunnel/config.json shared between web and Mac apps

New Session Path Autocomplete (#435)

• Intelligent path autocomplete when creating sessions with unified UI
• Home directory expansion (~/ shortcuts work properly)
• Visual file browser with folder icons for easy navigation
• Git repository discovery shows current branch in file browser
• Repository status displayed in welcome screen
• Escape key support and auto-select first suggestion

Session Status Management

• New dropdown menu in session headers for running/exited sessions
• Terminate running sessions without closing the tab
• Clear exited sessions individually with one click
• Visual status indicators - pulsing dot for running, static for exited
• Keyboard navigation support (Arrow keys, Enter, Escape)

Image Upload Menu (#432)

• New image upload feature in session headers with multiple input methods:
  • Paste images from clipboard
  • Select from photo library (mobile)
  • Take photo with camera (mobile)
  • Browse for files
• Automatically converts images to base64 and inserts at cursor position
• Mobile-optimized UI with full-screen menu

Linux Systemd Support (#426)

• Run VibeTunnel as a persistent service with vibetunnel systemd install
• User-level service - no root required
• Automatic startup on boot
• Smart Node.js detection works with nvm, fnm, or global npm
• Comprehensive systemd commands for status, logs, start/stop

🎨 UI Improvements

• Mobile Terminal Experience (#441)
  • Fixed keyboard layout issues on mobile devices
  • Improved quick keys bar with better sizing and spacing
  • Responsive text sizes that scale properly on smaller screens
  • Tab key now works correctly on mobile keyboards
• Dark Mode & Theme Improvements
  • Improved theme toggle with clearer icon and tooltips (#438, fixes #368)
  • Fixed new session dialog styling for dark mode (#433)
  • Better contrast and visibility across all themes
• General UI Polish
  • Clickable ngrok URLs in Settings with copy button (#422)
  • Cleaner session headers with better-positioned controls
  • Fixed magic wand icon alignment for AI sessions
  • Edit icons now positioned directly after text instead of far right
  • Improved OPTIONS label alignment in session create form

🐛 Bug Fixes

• Fixed session timers continuing to run after sessions exited (#428)
• Fixed sessions with undefined activity status showing as idle instead of active
• Fixed new session dialog styling for dark mode (#433)
• Fixed Mintlify documentation generation (#434)
• Fixed ConfigManager threading crash when moving quick start items in macOS
• Fixed mobile keyboard layout and text sizing issues (#441)
• Improved Chinese input method support (#431, duplicate of #421)
• Fixed OpenCode support for better integration with external apps

View full changelog

Pre-release version

Terminal Performance Mode (Experimental)

• New binary WebSocket mode for terminal sessions dramatically improves performance for high-throughput operations (#412)
• Toggle between standard SSE mode and high-performance binary mode in terminal settings
• Binary mode significantly reduces latency and CPU usage when running commands with heavy output
• Seamless switching between modes without losing your session

Enhanced Terminal Control

• Uninstall option for the vt command line tool now available in settings (#407)
• Simple trash icon button to cleanly remove the CLI tool when needed
• Proper cleanup of both standard and Homebrew installation paths

Screen Sharing Removed

• Removed screen sharing feature to focus on core terminal functionality (#415)
• Eliminated ~17,000 lines of WebRTC and screen capture code
• No longer requests screen recording permissions
• Screen Sharing is out of scope for the 1.0 release

🐛 Bug Fixes

• Fixed server crashes when using special characters (like *) in terminal status messages (#398)
• Resolved "Kill All Sessions" button failing silently in compact/sidebar view (#418)
• Fixed network bind address reverting to localhost after server restarts (#404)
• Ghostty terminal now properly spawns and executes commands if there are no windows (#408)

📚 Documentation

• Added complete HQ mode documentation covering distributed deployments
• Organized all documentation into logical categories with Mintlify

View full changelog

Pre-release version

Welcome Screen Performance

• Background folder scanning eliminates UI freeze when opening the welcome screen (#394)
• Improved startup performance with optimized web directory structure
• Much smoother experience when working with large project directories

SSH Agent Reliability

• Fixed SSH key generation errors on non-localhost HTTP connections (#392)
• SSH agent now works correctly when accessing VibeTunnel via ngrok or from another device
• Improved security and reliability for remote access scenarios

npm Package Stability

• Fixed critical installation issues on Linux systems (#393)
• authenticate-pam now properly handled as optional dependency
• Enhanced cross-platform compatibility for Ubuntu and other distributions
• Comprehensive vt command tests ensure reliability across environments

Developer Experience

• Fixed missing public directory in Mac app bundle (#392)
• Resolved TypeScript type annotations throughout codebase
• Improved lint compliance and code quality
• Streamlined CI/CD workflow for more reliable builds

🐛 Bug Fixes

• Fixed vt command syntax errors on Linux systems (#393)
• Fixed welcome screen lag during folder scanning (#394)
• Resolved missing icons and resources in Mac app
• Fixed lint and type errors across the codebase
• Cleaned up duplicate and stray files from web directory

Pre-release version

Better Settings Organization

• Reorganized settings into logical tabs for easier navigation (#359)
• Repository base path now syncs automatically between Mac app and web UI (#358)
• Simplified welcome screen repository display (#372)

Improved WebRTC Support

• Fixed threading issues in WebRTC screen capture (#375, #378)
• Resolved screen capture authentication problems (#264, #374)
• More stable screen sharing with proper main thread dispatch

UI Context Awareness

• Screen sharing button only appears when Mac app is connected (#367)
• Spawn window toggle shows only when relevant (#357)

NPM Package Now Available

• vibetunnel (server) is now available as an npm package for easy installation on macOS and Linux (#360, #377)
• Install with npm install -g vibetunnel - no build tools required!
• Includes prebuilt binaries for Node.js 20, 22, 23, and 24
• Supports macOS (Intel and Apple Silicon) and Linux (x64 and arm64) (#344)

Enhanced Git Diff Tool Support

• Added JuxtaCode to the list of supported Git diff tools with automatic detection

Improved vt Command

• Added verbosity control with -q (quiet), -v (verbose), -vv (extra verbose) flags (#356)
• New vt title command to update session names from within a VibeTunnel session

🐛 Bug Fixes

• Fixed npm package installation issues (#360, #377)
• Fixed control message processing loop (#372)
• Fixed file browser constant refresh issue (#354)
• Replaced bell icon with settings icon for better clarity (#366)
• Resolved Tailwind CSS performance warning
• Fixed repeated screen recording permission dialogs

Pre-release version

🎯 Major Features

Repository Discovery

• Automatic Git repository detection when creating new sessions
• Recently modified repositories are displayed in the new session dialog
• Quick project access with one-click repository selection

Keyboard Shortcut Handling

• Redesigned keyboard capture system with intelligent priority handling
• Browser shortcuts now work naturally: Cmd+Shift+A (tab search), Cmd+1-9 (tab switching), Alt+Arrow keys (browser navigation)
• Visual keyboard capture indicator with detailed tooltips
• Double-Escape toggle for switching between browser and terminal keyboard modes

Theme System

• Dracula theme is now the default for new users
• Professional light mode with improved contrast and modern styling
• Easy theme switching between light and dark modes
• Enhanced terminal color schemes and theme management

🚀 Performance & Developer Experience

Development Server Mode

• New "Development Server" mode in Debug Settings enables hot reload for web changes
• Significantly faster iteration when developing the web interface
• Hot reload works with full VibeTunnel functionality

🛠️ Bug Fixes & Improvements

Cross-Platform Compatibility

• FIXED: Safari clipboard paste now works reliably on iOS and macOS
• Improved mobile experience with better responsive behavior
• Enhanced cross-browser compatibility

Session Management

• FIXED: Prevented duplicate session creation with intelligent detection
• Added keyboard navigation in session grid (arrow keys, Enter, etc.)
• Improved session organization and list management

Network & SSH

• FIXED: Race conditions in network access mode that caused connection failures
• More robust network configuration handling and error recovery
• Improved SSH key manager with better modal layout and responsive design

🔧 Under the Hood

• Updated all dependencies to latest stable versions
• Enhanced TypeScript configuration with better type safety
• Simplified CI workflow and improved build reliability
• More comprehensive test suite with better coverage

View full changelog

Pre-release version

🛡️ Stability & Reliability

Critical Crash Fix

• FIXED: Eliminated random terminal crashes by replacing Microsoft's node-pty with a custom fork that provides thread-safe operations and better resource management. This resolves critical stability issues that affected VS Code and other Electron applications.

Server Crash Detection

• NEW: Intelligent crash detection and recovery system that automatically detects server failures and provides immediate feedback with specific error codes, dramatically reducing troubleshooting time.

📱 Mobile Experience

Terminal Stability on Mobile

• FIXED: Resolved the continuous resize loop that made terminals unusable on mobile devices. The terminal now maintains a stable view without jumping or unexpected scrolling.
• IMPROVED: Better mobile terminal width management - user preferences are now properly respected throughout the session.
• ENHANCED: Support for smaller grid sizes on compact mobile devices, providing better visibility on phones.

Mobile Keyboard Support

• NEW: Added Alt+Delete/Left/Right keyboard shortcuts specifically for mobile users, improving text editing capabilities.
• FIXED: Mobile header no longer overflows when using dropdown menus, providing a cleaner interface.

🚀 Features & Improvements

Cloudflare Integration

• ENHANCED: Significantly improved Cloudflare tunnel setup with faster, more reliable stream-based monitoring instead of polling. Setup is now smoother with better error handling.

Git Repository Discovery

• IMPROVED: Enhanced folder selection when creating new sessions - VibeTunnel now intelligently discovers Git repositories in your selected folder, making project navigation easier.
• FIXED: Several bugs in repository discovery that could cause incorrect folder detection or errors.

🎨 UI Polish

Visual Stability

• FIXED: Terminal titles no longer jump around due to activity indicators, providing a stable and professional interface.
• IMPROVED: Consolidated z-index management throughout the interface, preventing UI elements from appearing in incorrect layers.

🔧 Under the Hood

• Enhanced event handling for better cross-platform compatibility
• Improved file browser functionality with better click handling
• Updated documentation with expanded specifications and data flow diagrams
• Various test improvements for better code quality

Pre-release version

Homebrew Library Dependencies

• FIXED: Release builds now correctly bundle all Homebrew library dependencies
• FIXED: App launches reliably on systems without developer tools installed
• Updated build scripts to handle dynamic library dependencies properly

File Browser Enhancements

• FIXED: File browser going dark due to event bubbling issues with modal handling

Pre-release version

🎯 Major Features

🖥️ Remote Screen Sharing (Beta)

• Share your Mac screen remotely through any web browser - perfect for demonstrations, pair programming, or remote support
• Ultra-low latency using WebRTC technology with automatic quality adjustment based on network conditions
• Privacy-focused with deferred permission requests (only asks for screen recording when you actually start sharing)
• Automatic 4K resolution capping for 5K+ displays to prevent web interface clipping
• Clear visual indicators when screen sharing is active

🪄 Magic Wand for AI Sessions

• Instantly inject helpful context into Claude.ai sessions with a single click
• Automatically detects Claude browser windows and adds project information
• Includes git repository details, current branch, and recent commit history
• Configurable prompts to match your workflow
• More forceful prompt injection to prevent AI from directly using the injected title

🚀 Performance & Stability Improvements

Terminal Performance

• FIXED: Critical flow control issue that caused xterm.js buffer overflow and terminal freezing
• FIXED: Infinite scroll loop in terminal output that could freeze the browser
• FIXED: Race conditions in terminal output handling causing corrupted or out-of-order text
• Improved memory management for long-running sessions
• Better handling of high-volume terminal output

UI Performance

• Removed all UI animations that were causing 1-2 second delays when reopening sessions
• Disabled View Transitions API for instant session navigation
• Fixed modal backdrop pointer-events issues preventing interaction
• Smoother menu bar UI without jumping when copy icon appears

📱 Touch Device & Mobile Improvements

iPad/Tablet Support

• Unified keyboard layout for all mobile devices (removed separate iPad layout)
• Universal touch device detection for better keyboard mode handling
• Inline-edit pencil now always visible on touch devices
• Reorganized touch device layout with better button placement
• Fixed touch interaction issues with modals and overlays

Mobile Keyboard

• New compact keyboard layout optimized for tablets
• Better handling of keyboard shortcuts on touch devices
• Improved responsiveness for mobile web browsers

🐚 Shell Support Enhancements

Fish Shell Integration

• Full support for Fish shell command expansion and completions
• Proper handling of Fish-specific syntax and features
• Fixed shell configuration files not being loaded correctly

🔧 Developer Experience

Build System Improvements

• Preserve Swift package resolution in build.sh for faster builds
• Better Node.js detection that handles fnm/homebrew conflicts

Version Management

• Implemented hash-based vt script version detection
• Delete old sessions automatically when VibeTunnel version changes
• Better handling of version mismatches between components

🐛 Bug Fixes

Session Management

• Fixed session state synchronization between web and native clients
• Resolved memory leaks in long-running sessions
• Fixed connection timeout issues on slower networks
• Better cleanup of terminal processes and resources

UI/UX Fixes

• Fixed various UI glitches and visual artifacts
• Resolved sidebar animation issues
• Fixed file browser problems
• Corrected ngrok documentation about free static domains

🔍 Other Improvements

Control Protocol

• Unified control protocol for better terminal and screen sharing integration
• Improved Unix socket handling with better error recovery
• Enhanced WebRTC connection management

Documentation

• Updated ngrok docs to clarify one free static domain per user
• Added comprehensive ScreenCaptureKit documentation
• Removed outdated debug documentation

Pre-release version

Pre-release version

Pre-release version

Pre-release version

Pre-release version

Pre-release version