desktop-bridge

File bridge: user’s devices ↔ agent workspace via WebDAV + Cloudflare Tunnel.

Start

• Before starting, ask the user: read-only or full read-write access?
• bash {baseDir}/scripts/start.sh --path "$HOME/workspace"
• Add --read-only if user chose read-only
• Prints tunnel URL + credentials. Give all three to the user.
• --port 9090 custom port (default 8080)
• --user alice --pass secret custom credentials (default: bridge / auto-generated)
• First positional arg = --path for convenience

Stop

• bash {baseDir}/scripts/stop.sh

Status

• bash {baseDir}/scripts/status.sh
• Shows connection info if running, suggests start if not

How the user connects (tell them)

• macOS Finder: Cmd+K → paste URL
• Windows Explorer: Map Network Drive → paste URL
• Linux GNOME: Files → Other Locations → davs:// + hostname
• Linux KDE: Dolphin → webdavs:// + hostname
• iOS Files: Connect to Server → paste URL
• Android: CX File Explorer → Remote → WebDAV (host, port 443, HTTPS)
• Obsidian: Remotely Save plugin → WebDAV → paste URL
• Enter username and password when prompted

Manual install (if brew is unavailable)

• rclone: curl -fsSL https://rclone.org/install.sh | bash or download from https://rclone.org/downloads/
• cloudflared: download from https://github.com/cloudflare/cloudflared/releases/latest

Notes

• Tunnel URL changes on every restart (free Cloudflare quick tunnel).
• 100 MB max file size (Cloudflare free tier limit).
• Bridge runs in background — no open terminal needed.
• Always stop when user is done.
• State files in ${DESKTOP_BRIDGE_DIR:-${TMPDIR:-/tmp}/desktop-bridge} (never in skill dir).