Skip to content
labs.Independent tools. Open source.
← All tools
Desktop

herdr-remote

Watch coding agents on your Mac from an Android phone. Read transcripts, answer prompts and send messages.

Platform
Android + macOS
Licence
MIT
Documentation
Read the guide

In the app

4 images
Spaces
Pane design preview of the herdr-remote Spaces screen with sample agent states and spaces

Design preview from the project's Pane mockups. Sample spaces and agent states illustrate the layout.

1 of 4

Keep up with your agents

herdr-remote connects an Android phone to Herdr.app on one Mac. Check which agents need attention, read their transcripts and inspect live terminal output.

The phone connects to a Go daemon on your Mac over Wi-Fi or Tailscale. Mutual TLS authenticates paired devices. The project uses no relay server.

This is an independent project. It is not made by, or affiliated with, the makers of Herdr.

What you can do

  • Browse spaces and agent states.
  • Read Claude Code and Codex transcripts, with a live terminal view as a fallback.
  • Approve or deny supported permission prompts and answer supported questions.
  • Send a message to an agent.
  • Enable optional alerts when an agent needs attention or finishes.
  • Pair and revoke phones through the Herdr mod on your Mac.

Getting started

Clone the source and install the Mac daemon and Herdr mod:

git clone https://github.com/Captain-Sangam/herdr-remote.git
cd herdr-remote
scripts/install.sh

The install script builds herdr-remoted and starts it as a macOS LaunchAgent. Allow incoming connections if macOS requests permission.

Set up the Android tools and build the app:

scripts/setup-android.sh
cd android
JAVA_HOME=/opt/homebrew/opt/openjdk@17 \
  ANDROID_HOME=/opt/homebrew/share/android-commandlinetools \
  ./gradlew assembleDebug

Connect your phone through USB and install the APK:

/opt/homebrew/share/android-commandlinetools/platform-tools/adb install -r \
  app/build/outputs/apk/debug/app-debug.apk

Open the herdr-remote mod in Herdr.app. Select Pair a phone, scan the QR code and compare the six-digit codes. Allow the phone only if they match.

For full Codex transcripts, configure Herdr to launch Codex with --no-daemon. See the deployment guide for the complete setup.

Things to know

  • A paired phone can approve commands and send messages on your Mac. Pair only phones that you own. Revoke lost devices promptly.
  • The live terminal view is read-only. Supported prompts and messages use separate controls.
  • The daemon checks approval state and local Mac activity. These checks have a documented race: a key can reach a changed prompt.
  • Transcripts and terminal output stay in the phone’s memory. Agent tools may still use their own cloud services.
  • The gallery shows the project’s design previews. The installed app has documented differences from these mockups.
  • Build and install the Android app from source. This page does not offer a packaged download.

Read the architecture and security model and operating notes before use.

Explore the source

herdr-remote uses the MIT licence. See the documentation index for the API, design decisions and development guides.