Build custom versions (macOS): ./build-custom-mac-version.sh [VARIATION_NAME] to create a custom build with the variation name included in both the app file name and displayed app name (e.g., ./build-custom-mac-version.sh Nov2 creates VibeTreeNov2.app which displays as "VibeTreeNov2" when opened)

Testing with Auto-Open Project

bin/launch-with-project /path/to/project [--name "CustomName"] - Launch app with auto-opened project. Optional --name sets window title for easy identification.

Web/Mobile Access

1. Start services: pnpm dev:all
2. Access locally: http://localhost:3000
3. For mobile/network access:
   • Scan the QR code shown in terminal
   • Or navigate to the network URL (e.g., http://192.168.1.x:3000)

🐳 Docker Deployment

Deploy VibeTree on any VM or cloud instance with one command:

npm run deploy

This automatically builds and runs VibeTree in a Docker container. Perfect for deployment on EC2, Digital Ocean, or any Docker-enabled environment. See DOCKER.md for detailed instructions.

Access VibeTree:

• Web Interface: http://localhost:3000
• API Server: http://localhost:3002
• Health Check: http://localhost:3002/health

Cloud Deployment

Deploy on AWS EC2, Digital Ocean, or any cloud VM:

# On your cloud instance
git clone <your-repo>
cd vibe-tree
npm run deploy

Configure security groups to allow ports 3000 and 3002, then access via http://your-vm-ip:3000.

Safari/iOS Requirements:

• Both services must be running (web on random 3XXX port, server on random 3XXX port)
• Allow firewall connections on both ports if prompted

LAN Dev Mode (no pairing)

When opening from a phone on your Wi‑Fi, the web UI loads over LAN and the web app automatically discovers and connects to the socket server via WebSocket. In development, enable LAN WebSocket access without pairing:

# Allow LAN connections to the WebSocket server in dev (no auth)
ALLOW_INSECURE_NETWORK=1 HOST=0.0.0.0 pnpm dev:server
pnpm dev:web

Then open the printed Network URL (e.g., http://192.168.1.x:3000) on your phone. If you still see "Not connected", you can explicitly point the web app at the socket server by creating apps/web/.env:

VITE_WS_URL=ws://192.168.1.x:XXXX  # Replace XXXX with actual server port

Environment Variables

Create .env files as needed:

# apps/web/.env (optional)
VITE_WS_URL=ws://192.168.1.100:XXXX     # For custom socket server (replace XXXX with actual port)
VITE_PROJECT_PATH=/path/to/project       # Override project path

# apps/server/.env (optional)
PORT=3002                              # Socket server port (optional, uses random port by default)
HOST=0.0.0.0                          # Bind to all interfaces
PROJECT_PATH=/path/to/project          # Default project path
# In dev, allow unauthenticated LAN WebSocket connections (use only on trusted networks)
# Any of these enables it:
# ALLOW_INSECURE_NETWORK=1
# ALLOW_INSECURE_LAN=1
# ALLOW_NETWORK_DEV=1
DEFAULT_PROJECTS=/path1,/path2         # Auto-load projects (first becomes default)
# Authentication (for webapp login)
USERNAME=your_username                  # Set username for authentication
PASSWORD=your_password                  # Set password for authentication
AUTH_REQUIRED=true                     # Enable authentication

# Docker-specific variables
PROJECT_PATH=/workspace                 # Project directory inside container
WEB_PORT=3000                          # Web frontend port
NODE_ENV=production                    # Runtime environment

Features

• Parallel Development - Work on multiple features simultaneously without stashing or switching branches
• Persistent Terminal Sessions - Each worktree maintains its own terminal session with full state preservation
• Claude CLI Integration - Seamlessly work with Claude in each terminal
• IDE Integration - Open any worktree directly in VS Code or Cursor
• Multi-Project Support - Work with multiple repositories in tabbed interface
• Cross-Platform Access - Desktop app, web browser, and mobile support
• Docker Deployment - One-command deployment for cloud VMs and production environments
• Dark/Light Mode - Automatic OS theme detection with manual toggle
• macOS Native - Proper traffic light window controls integration

Roadmap

• [x] Mobile access - Access from your phone via web browser
• [ ] Claude notifications - Get notified when Claude finishes tasks or needs user input
• [ ] PWA offline support - Work offline on mobile devices

Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on our code of conduct and the process for submitting pull requests.

License

MIT License - see the LICENSE file for details.