Quickstart

Four steps#

1. 1

   Install the bridge on your computer

   macOS or Linux · install scriptCopy

   curl -fsSL https://crow.sg/apps/ai-agent-remote/install.sh | sh

   HomebrewCopy

   brew tap crow-tech-pte-ltd/agent-remote-bridge https://github.com/Crow-Tech-Pte-Ltd/agent-remote-bridgebrew install agent-remote-bridge

   Both put herdr-remote on your path. The script installs to ~/.local/bin without sudo and checks the download against the release’s SHA-256 checksums.

   The script is published on crow.sg from install.sh in the bridge repository, and downloads the kits from its GitHub Releases. To read it before running it: curl -fsSL https://crow.sg/apps/ai-agent-remote/install.sh | less

   Or download a release kit by hand.

2. 2

   Start it

   TerminalCopy

   herdr-remote up

   On first run, up creates the bridge’s private state in ~/.local/share/herdr-remote: a TLS certificate for this computer’s .local name and network addresses, and a small database of paired phones. It then listens on port 8443, advertises the computer to phones on the same network, and opens the web console in your browser.

   First start

   Created bridge state in /Users/you/.local/share/herdr-remote  address  https://studio.local:8443 (also 192.168.1.20)  pin      81d45cb9b691e5d8a3254dbac95ce7fb3fc170d266cf53d0d906117e62b54e6c{"event":"listening","url":"https://studio.local:8443","discoverable":true,…}Console: http://127.0.0.1:8790/#launch=…

   No Herdr?

   Run herdr-remote up --backend plain. The bridge then runs its own login shells, one in your home folder to start with, and you add project folders from the phone. Agents you start in them are recognised. The choice is remembered, so later a plain up is enough. With Herdr, run the bridge in a Herdr tab so it finds the herdr command, or pass --herdr "$(which herdr)".

   macOS may ask to allow incoming connections or devices on your local network: allow both. On Linux, install avahi-utils so phones can find the computer, and allow TCP port 8443 from your network if a firewall is on.

3. 3

   Install the app

   iPhone & iPadComing soon to the App Store

   AndroidComing soon

   Bridge for macOS & LinuxFree and open source · GitHub

   Before you pair, Explore preview in the app shows clearly labelled sample projects, so you can look around without a computer.

4. 4

   Pair with the code on your computer

   Open the app and allow Local Network access. Your computer appears under On this network. Tap Pair: a 6-digit code pops up on the computer (as a notification, in Herdr, and in the terminal running up). Type it on the phone and check that the fingerprint matches on both screens.

   On the computer

   Pairing request: Example iPhone  Code 482 913 · fingerprint b636-f910  Type this code on the phone. It expires in 2 minutes.

   

   

   

   Done. The phone saves the computer and reconnects by itself from now on. Open Projects, pick a pane, and you are watching it live.

Where next#

• Keep the bridge running after you close the terminal: run it as a service.
• Pair on a network you don’t trust, or pair read-only: use a QR invitation.
• Learn the terminal controls, history, voice notes and changes in Using the app.
• Leave the house: reach the computer from anywhere.