# AI use cases for Roamgate (powerfooI/roamgate) Repo: [powerfooI/roamgate](https://github.com/powerfooI/roamgate) | Use cases: 4 | Page: https://dedupedai.com/use-cases/powerfooi-roamgate/ Roamgate is a browser and PWA client for Herdr that lets you view and control workspaces, coding agent sessions, terminals, files, and diffs from desktop or mobile. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Continue a Herdr workspace on your phone: https://dedupedai.com/use-cases/powerfooi-roamgate/continue-herdr-workspace-on-phone/ - Review agent code changes and diffs in a browser: https://dedupedai.com/use-cases/powerfooi-roamgate/review-agent-code-changes-in-browser/ - Monitor agent sessions and run tests from a phone: https://dedupedai.com/use-cases/powerfooi-roamgate/monitor-agent-sessions-and-run-tests-from-phone/ - Run Roamgate from source to develop or test it: https://dedupedai.com/use-cases/powerfooi-roamgate/run-roamgate-from-source-for-development/ ## How to continue a Herdr workspace on your phone with Roamgate Repo: [powerfooI/roamgate](https://github.com/powerfooI/roamgate) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Start work on a computer, then pick up the same Herdr workspace and sessions from a phone through Roamgate. **Who it is for:** A developer who starts agent sessions at a desk and wants to check progress or step in from a phone while away. **The problem:** Your Herdr sessions live on one machine, so leaving the desk usually means losing access to the work in progress. **The outcome:** The same workspace, agent sessions, and terminals open in a phone browser or installed PWA while Herdr keeps running. ### Steps 1. Install and start Herdr, or run `roamgate herdr setup` later to let Roamgate do it. 2. Install Roamgate with `curl -fsSL https://github.com/powerfooI/roamgate/releases/latest/download/install-roamgate.sh | sh` on Linux or macOS. (inferred, check the README) 3. Run `roamgate` and open the printed URL in a browser on the computer, then log in. 4. Run `roamgate url --qr` and scan the QR code with your phone. 5. On iPhone or iPad Safari, use Share and then Add to Home Screen to install the app. ### Prompt to paste into your agent ```text Using the powerfooI/roamgate README, set up Roamgate on so a phone can reach the running Herdr workspace. Run `roamgate url --qr` and report the URL and the QR output. Verify that the URL loads the workspace list after login before reporting success. ``` ### Caveat The README says a PWA is not offline access, so Roamgate must stay running and reachable from the phone for this to work. Risk, remote script: The quick install pipes a script from GitHub Releases directly into sh, so review the script or pin a version with ROAMGATE_VERSION before running it. Risk, credentials: Normal runtime requires login, and a phone that gets the URL or QR code gains access to terminals and real files, so protect the login and read SECURITY.md before giving another device access. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/powerfooi-roamgate/continue-herdr-workspace-on-phone/ ## How to review agent code changes and diffs in a browser with Roamgate Repo: [powerfooI/roamgate](https://github.com/powerfooI/roamgate) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Open the files and diffs a coding agent changed in Herdr, then review them with annotations in the browser. **Who it is for:** A developer or reviewer who needs to check what an agent changed in a workspace before accepting it. **The problem:** Agent edits land in a live workspace, and checking them means switching between terminals, files, and diff tools. **The outcome:** Changed files, diffs, and inline diff annotations are reviewed in one browser view tied to the Herdr workspace. ### Steps 1. Install and start Herdr, then install Roamgate as described in the quick start. 2. Run `roamgate` and open the printed URL in a desktop browser. 3. Log in, open the workspace where the agent worked, and open the file explorer. 4. Open the code changes view and go through each diff. 5. Add diff annotations to lines that need follow-up, then run `roamgate doctor` if the workspace does not load. ### Prompt to paste into your agent ```text Using the powerfooI/roamgate README, open the Herdr workspace in Roamgate and list the files with code changes. Report each changed file path and whether a diff annotation was added. Verify the list matches the changes shown in the Herdr workspace before finishing. ``` ### Caveat The README describes diff review and annotations but does not describe how annotations are stored or shared, so check the docs before relying on them as a record. Risk, credentials: Review access shows real project files, so keep the Roamgate login private and avoid opening it on shared machines. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/powerfooi-roamgate/review-agent-code-changes-in-browser/ ## How to monitor agent sessions and run tests from a phone with Roamgate Repo: [powerfooI/roamgate](https://github.com/powerfooI/roamgate) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Check agent activity, run commands in a terminal, and preview output on a phone while away from the desk. **Who it is for:** A developer who has agents running long tasks and wants to check progress, run tests, or view an HTML preview from a phone. **The problem:** Long agent runs leave you guessing about progress, and checking requires being back at the computer. **The outcome:** Agent activity, terminal output, test results, and HTML previews are visible on a phone through the same Roamgate session. ### Steps 1. Start Herdr with the agent sessions you want to monitor. 2. Run `roamgate` on the host machine and confirm the printed URL works in a desktop browser. 3. Run `roamgate url --qr` and scan the code with your phone to open Roamgate. 4. Open the agent session to check activity and inspect the conversation. 5. Open the terminal to run a test command, then open the HTML preview to see the result. ### Prompt to paste into your agent ```text Using the powerfooI/roamgate README, connect to the Roamgate instance at and report the status of the agent session named . Include the latest terminal output and whether tests passed. Verify the status matches what the Herdr session shows before reporting. ``` ### Caveat Roamgate controls terminals and real files, and the README says to keep the default loopback binding and read SECURITY.md before giving another device access. Risk, credentials: Running commands from a phone gives full terminal control, so use a strong login and only expose Roamgate to devices you trust. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/powerfooi-roamgate/monitor-agent-sessions-and-run-tests-from-phone/ ## How to run Roamgate from source to develop or test it with Roamgate Repo: [powerfooI/roamgate](https://github.com/powerfooI/roamgate) | Difficulty: Advanced | Time: 60 minutes | Basis: From the README Install dependencies with Bun and start the server and web app in separate terminals. **Who it is for:** A contributor who wants to change Roamgate or test a fix against a running Herdr server. **The problem:** Testing a change to the client or server needs the dev servers running against a live Herdr instance. **The outcome:** The development server and web client run locally and load against a running Herdr server. ### Steps 1. Install Bun 1.4.3 or newer and start a Herdr server. 2. Run `bun install --frozen-lockfile` in the repository root. 3. In one terminal, run `bun run dev:server`. 4. In a second terminal, run `bun run dev:web`. 5. Open the URL printed by the web server, and read CONTRIBUTING.md before opening a pull request. ### Prompt to paste into your agent ```text Using the powerfooI/roamgate README, clone the repository and start the dev server and web app against a running Herdr server. Report the URL the web app prints and whether it loads. Verify the page responds before reporting success. ``` ### Caveat The README says only the loopback development server skips login, so keep it bound to loopback and never reachable from other machines. Risk, credentials: The loopback development server skips login, so do not expose `bun run dev:server` to other networks or devices. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/powerfooi-roamgate/run-roamgate-from-source-for-development/