vibestreak-server

Companion server that bridges the Vibestreak iOS app to Claude Code CLI. Code from your phone with AI — anywhere.

Quick Start

npx vibestreak-server --tunnel --cwd ~/your-project

Then scan the QR code in the Vibestreak app to connect.

Prerequisites

• Node.js 18+ — Download
• Claude Code CLI — Install with npm install -g @anthropic-ai/claude-code
• cloudflared (optional, for remote access via --tunnel) — see installation below

Usage

# Start in current directory with remote tunnel
npx vibestreak-server --tunnel

# Start with a specific project directory
npx vibestreak-server --tunnel --cwd /path/to/project

# LAN-only mode (no tunnel, same network required)
npx vibestreak-server

# Custom port
npx vibestreak-server --port 8080 --tunnel

# Continue last Claude session
npx vibestreak-server --tunnel --continue

# Resume a specific session
npx vibestreak-server --tunnel --resume <session-id>

CLI Options

| Flag | Description | Default | |------|-------------|---------| | --tunnel | Enable Cloudflare tunnel for remote access | Off (LAN only) | | --cwd <path> | Project directory for Claude to work in | Current directory | | --port <number> | HTTP/WebSocket server port | 19275 | | --continue | Continue the last Claude session | — | | --resume <id> | Resume a specific Claude session by ID | — | | --token <token> | Override auth token (auto-generated if omitted) | Random |

How It Works

Vibestreak iOS App  <——WebSocket——>  vibestreak-server  <——stdio——>  Claude Code CLI
     (phone)            (tunnel)         (your PC)                    (your PC)

1. The server starts Claude Code CLI as a subprocess
2. Your phone connects via WebSocket (through a Cloudflare tunnel or local network)
3. Messages are relayed between the app and Claude Code
4. Claude has full access to your project directory (reads, writes, runs commands)

Platform Support

Core Server

Works on macOS, Windows, and Linux — anywhere Node.js and Claude Code CLI run.

Live Preview (Screenshots)

The screenshot feature captures your screen for in-app preview:

| Platform | Desktop Screenshot | iOS Simulator | |----------|-------------------|---------------| | macOS | screencapture | xcrun simctl | | Windows | PowerShell (System.Drawing) | Not available | | Linux | gnome-screenshot / scrot / import | Not available |

Cloudflared Installation

Remote access (--tunnel) requires cloudflared:

• macOS: brew install cloudflared
• Windows: winget install Cloudflare.cloudflared or choco install cloudflared
• Linux: sudo apt install cloudflared or download from Cloudflare

Without cloudflared, the server runs in LAN-only mode (phone and PC must be on the same network).

Terminal Commands

While the server is running, you can type directly in the terminal:

• Type any message to send it to Claude (just like the app)
• /status — Show connection status
• /clear — Clear the terminal
• /quit — Shut down the server

Troubleshooting

"Claude CLI is not ready"

Ensure Claude Code is installed and in your PATH:

claude --version

If not installed: npm install -g @anthropic-ai/claude-code

"cloudflared: command not found"

Install cloudflared for your platform (see above), or run without --tunnel for LAN-only mode.

Screenshot not working

• macOS: Grant Terminal "Screen Recording" permission in System Settings > Privacy & Security
• Windows: Ensure PowerShell is available (comes pre-installed on Windows 10+)
• Linux: Install gnome-screenshot, scrot, or imagemagick

App can't connect

• With --tunnel: Check that the QR code is scanned correctly and cloudflared is running
• Without --tunnel: Ensure phone and PC are on the same Wi-Fi network

License

MIT