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.

Workspace overview	File explorer	Diff annotations

Mobile

Code changes	Terminal and tests	HTML preview

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.

Desktop	Mobile

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

1. Install and start Herdr, or let Roamgate do it later with roamgate herdr setup.

2. 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 \
     | sh

   On Windows, download the x64 or ARM64 archive from the latest release.

3. Run roamgate (roamgate.exe on Windows; on Linux/macOS make sure ~/.local/bin is on PATH) and open the printed URL. roamgate url --qr shows a QR code for your phone, and roamgate doctor diagnoses 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.3 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.