Skip to content

getting-started.mdx

Latest commit

 

History

History
47 lines (33 loc) · 1.38 KB

getting-started.mdx

File metadata and controls

47 lines (33 loc) · 1.38 KB
Raw
title Getting Started
description Set up the desktop bridge and pair the mobile app in minutes.
icon rocket

Prerequisites

  • Rust toolchain (for the bridge)
  • Node.js 18+
  • Tailscale (recommended) or same‑LAN connectivity

1) Start Tricoder CLI

npx tricoder@latest

What it does

  • Starts the desktop bridge automatically
  • Prints your Desktop IP and a pairing QR/deep link
  • Prefers your Tailscale IP (100.x) when available; otherwise falls back to LAN IP
  • Binds the bridge to 0.0.0.0:8787 by default so both Tailscale and LAN addresses work

2) Run the bridge (manual option)

If you prefer not to use the CLI helper, you can run the bridge directly:

cargo run -p oa-bridge -- --bind 0.0.0.0:8787

This launches the WebSocket at ws://<host>:8787/ws and sets up local sync.

3) Pair your phone

  • In your terminal, npx tricoder@latest prints a QR and a deep link.
  • On your phone, open Tricoder → Scan Code (or tap the deep link) to connect.
  • You can also manually enter your Desktop IP if needed.

4) You’re connected

The app shows bridge status and starts streaming runs. See Using Tricoder for basics (viewing history, sending prompts, interrupting runs).

Tips

  • Keep Tailscale running for reliable remote connectivity.
  • The bridge token is durable and stored in ~/.openagents/bridge.json so you don’t need to rescan after restarts.