roamgate
A Herdr client for any screen. Control terminals, monitor coding agents, and review files and diffs from desktop or mobile.
Automatically checked · GitHub checked 2026-11-12

Overview
Roamgate
A browser and PWA client for Herdr that brings your workspaces, coding agent sessions, terminals, files, and code reviews into one place. Check agent activity, inspect conversations, run commands, and review diffs from your browser. Work on any computer, then continue from your phone while Herdr keeps your sessions running.
Requires a running Herdr server.
Step away. Stay in flow.
Start on any computer. Leave Herdr running, then continue in the same workspace from your phone.
Screenshots
Desktop
A real Northstar demo workspace with code changes and passing tests.
Mobile
Ranger
An experimental workspace management assistant for desktop and mobile. Inspect workspace context, manage supported operations, and schedule background checks. Requires Herdr and the Roamgate bridge to be running.
Click any screenshot to open the full-resolution image.
Moving from Herdr Studio / herdr-gui? Follow the migration guide; automatic upgrades are not supported.
Quick start
-
Install and start Herdr, or let Roamgate do it later with
roamgate herdr setup. -
Install Roamgate on Linux or macOS (to pin a version, end the command with
| ROAMGATE_VERSION=X.Y.Z sh):curl -fsSL \ https://github.com/powerfooI/roamgate/releases/latest/download/install-roamgate.sh \ | shOn Windows, download the x64 or ARM64 archive from the latest release.
-
Run
roamgate(roamgate.exeon Windows; on Linux/macOS make sure~/.local/binis onPATH) and open the printed URL.roamgate url --qrshows a QR code for your phone, androamgate doctordiagnoses problems.
See deployment for configuration, services, and updates.
Install as a PWA
Recommended for daily use: a separate app window without browser tabs or the address bar. Log in to Roamgate, then install:
- iPhone/iPad Safari: Share -> Add to Home Screen.
- macOS Safari 17+: File -> Add to Dock.
- Chrome/Edge: browser menu -> Install app.
A PWA is not offline access: Roamgate must stay running and reachable.
Documentation
- Website and hands-on tutorial (Markdown): local work, mobile, and private remote access.
- Features and shortcuts
- Deployment: installation, configuration, services, builds.
- Architecture: system contracts.
- Security and contributing.
Development
Use Bun 1.4.4 or newer and a running Herdr server:
bun install --frozen-lockfile
# Run in separate terminals:
bun run dev:server
bun run dev:web
Open http://localhost:5173. See CONTRIBUTING.md for checks and pull requests.
Security
Roamgate controls terminals and real files. Normal runtime requires login, even
on loopback; only the loopback development server (bun run dev:server) skips
it. Keep the default loopback binding and read SECURITY.md
before giving another device access.
License
Code: MIT. Bundled fonts and brand assets retain their original terms; see THIRD_PARTY_NOTICES.md.








