# Roamgate

Roamgate logo

A **browser and PWA client** for [Herdr](https://herdr.dev) 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. [![Continue the same Herdr workspace from computer to phone with Roamgate][handoff-demo]][handoff-demo] ## Screenshots ### Desktop A real Northstar demo workspace with code changes and passing tests.
Workspace overview File explorer Diff annotations
Roamgate reviewing Northstar code changes beside passing tests Roamgate file explorer with the Northstar task board preview Northstar status-filter diff with a line comment and review feedback
### Mobile
Code changes Terminal and tests HTML preview
Northstar status-filter code diff in Roamgate on mobile Northstar passing tests with Roamgate's mobile Composer and terminal shortcuts Northstar task board in Roamgate's mobile static 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
Roamgate's Ranger workspace assistant on desktop Roamgate's Ranger workspace assistant on mobile
Click any screenshot to open the full-resolution image. [handoff-demo]: ./docs/images/roamgate-handoff.gif > **Moving from Herdr Studio / herdr-gui?** Follow the > [migration guide](./docs/DEPLOYMENT.md#transition-from-herdr-studio--herdr-gui); > automatic upgrades are not supported. ## Quick start 1. Install and start [Herdr](https://herdr.dev), 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`): ```bash 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](https://github.com/powerfooI/roamgate/releases/latest). 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](./docs/DEPLOYMENT.md) 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](https://roamgate.dev/) and [hands-on tutorial](https://roamgate.dev/tutorial/) ([Markdown](./docs/TUTORIAL.md)): local work, mobile, and private remote access. - [Features and shortcuts](./FEATURES.md) - [Deployment](./docs/DEPLOYMENT.md): installation, configuration, services, builds. - [Architecture](./docs/ARCHITECTURE.md): system contracts. - [Security](./SECURITY.md) and [contributing](./CONTRIBUTING.md). ## Development Use Bun 1.4.4 or newer and a running Herdr server: ```bash bun install --frozen-lockfile # Run in separate terminals: bun run dev:server bun run dev:web ``` Open . See [CONTRIBUTING.md](./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](./SECURITY.md) before giving another device access. ## License Code: [MIT](./LICENSE). Bundled fonts and brand assets retain their original terms; see [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md).