# AI use cases for Agent Chrome Relay (aindeev/agent-chrome-relay) Repo: [aindeev/agent-chrome-relay](https://github.com/aindeev/agent-chrome-relay) | Use cases: 4 | Page: https://dedupedai.com/use-cases/aindeev-agent-chrome-relay/ Chrome Relay is a macOS tool that lets coding agents drive your everyday Chrome, signed in as you, in background tabs from the command line. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Fill and submit a web form in your signed-in Chrome: https://dedupedai.com/use-cases/aindeev-agent-chrome-relay/fill-web-form-in-background-tab/ - Read a logged-in dashboard page step by step: https://dedupedai.com/use-cases/aindeev-agent-chrome-relay/check-logged-in-dashboard-step-by-step/ - Sign in to a site with 1Password, keeping secrets from the agent: https://dedupedai.com/use-cases/aindeev-agent-chrome-relay/sign-in-with-1password-without-agent-seeing-password/ - Approve agent browser actions from your iPhone: https://dedupedai.com/use-cases/aindeev-agent-chrome-relay/approve-agent-browser-actions-from-iphone/ ## How to fill and submit a web form in your signed-in Chrome with Agent Chrome Relay Repo: [aindeev/agent-chrome-relay](https://github.com/aindeev/agent-chrome-relay) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Have an agent complete a multi-step web form in a background tab using your existing login. **Who it is for:** A developer whose coding agent needs to submit a form, such as inviting a teammate, on a site where they are already signed in. **The problem:** Driving a page one command at a time costs the agent a model round trip per click, and the agent needs your logins to get past sign-in. **The outcome:** The goal is carried out in a background tab with the given data, and the run ends with a clear result: done when the success text is found, or handed back to the agent with the page and the choices it faced. ### Steps 1. Clone the repo: `git clone https://github.com/aindeev/agent-chrome-relay` 2. Enter the folder and build: `cd agent-chrome-relay` then `./build` 3. Run setup: `./chrome-relay setup` 4. Install Chrome Relay from the Chrome Web Store in your Chrome profile, pin it, and check with `chrome-relay doctor` 5. Run the goal: `chrome-relay do "Invite the new teammate as an admin" --url https://app.example.com/team/invite --profile you@company.com --data "Email=ada@example.com" --data "Role=Admin" --until "text:Invitation sent"` (inferred, check the README) ### Prompt to paste into your agent ```text Using the Chrome Relay repo at aindeev/agent-chrome-relay, run `chrome-relay do` with the goal "" on , passing the values in as --data options and --until "text:". Report the exit code and the final page text; exit code 2 means hand back to the user with the page state. Verify that the success text appears before reporting done. ``` ### Caveat The relay only works on Macs where the owner has set up the extension, and `do` can hand control back to the agent when it is unsure, so check the outcome before trusting it. 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/aindeev-agent-chrome-relay/fill-web-form-in-background-tab/ ## How to read a logged-in dashboard page step by step with Agent Chrome Relay Repo: [aindeev/agent-chrome-relay](https://github.com/aindeev/agent-chrome-relay) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README Let an agent open, read and screenshot a signed-in page one command at a time. **Who it is for:** A developer who needs a coding agent to check a live internal dashboard or account page that only works after sign-in. **The problem:** The agent cannot see pages that need your login, and driving them through a headless browser would not use your real session. **The outcome:** The agent gets the page's controls and visible text, and can check values, take a screenshot or confirm a condition, all in a tab that does not take focus. ### Steps 1. Complete the one-time setup with `./build` and `./chrome-relay setup` 2. Open the page in the agent's own tab: `chrome-relay open ` (use `--profile` to pick the Chrome profile) (inferred, check the README) 3. Read the controls and text: `chrome-relay snapshot --text` (inferred, check the README) 4. Check a value, for example with `chrome-relay get text` or `chrome-relay get url` (inferred, check the README) 5. Take a screenshot with `chrome-relay screenshot` and review the audit trail (inferred, check the README) ### Prompt to paste into your agent ```text Using the Chrome Relay repo at aindeev/agent-chrome-relay, open with chrome-relay open, read it with chrome-relay snapshot --text, and report the value of . Expected output: the text found on the page plus the current URL. Verify the URL matches before reporting. ``` ### Caveat The README describes the step commands for reading pages, but the exact output format of each command should be checked on your own Mac before you rely on it in a script. 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/aindeev-agent-chrome-relay/check-logged-in-dashboard-step-by-step/ ## How to sign in to a site with 1Password, keeping secrets from the agent with Agent Chrome Relay Repo: [aindeev/agent-chrome-relay](https://github.com/aindeev/agent-chrome-relay) | Difficulty: Advanced | Time: 30 minutes | Basis: From the README Have Chrome Relay type your 1Password credentials so the agent never sees them. **Who it is for:** A developer who uses 1Password and wants an agent to log into a site without being given the password or 2-step code. **The problem:** Agents need to log in to reach pages, but handing them passwords or one-time codes is a security risk. **The outcome:** Chrome Relay types the password, 2-step code or passkey from your shared 1Password vault into the login page, and the agent only sees the result of the sign-in. ### Steps 1. Build with Xcode command line tools installed (`xcode-select --install`), then run `./build` and `./chrome-relay setup` 2. Install and pin the Chrome Relay extension in the profile you use for the site 3. Use an op:// reference for the secret field, for example `chrome-relay fill op:////` (inferred, check the README) 4. Run the login step and check the page with `chrome-relay snapshot --text` (inferred, check the README) ### Prompt to paste into your agent ```text Using the Chrome Relay repo at aindeev/agent-chrome-relay, sign in to by filling the password field with an op:// reference from 1Password, never printing the value. Expected output: the signed-in page's title. Verify that the title matches before reporting success. ``` ### Caveat The README says 1Password is the only password manager supported for now, and passkeys and the Secure Enclave need the Xcode command line tools. Risk, credentials: This flow touches your 1Password vault and login secrets, so only point it at sites you own and check which vault items the agent can reference. 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/aindeev-agent-chrome-relay/sign-in-with-1password-without-agent-seeing-password/ ## How to approve agent browser actions from your iPhone with Agent Chrome Relay Repo: [aindeev/agent-chrome-relay](https://github.com/aindeev/agent-chrome-relay) | Difficulty: Advanced | Time: 30 minutes | Basis: From the README Receive and approve browser actions on your iPhone with Face ID while away from the Mac. **Who it is for:** A developer who starts agent browser work on a Mac and wants to approve sensitive steps from their phone when they are away. **The problem:** Agents can reach a point where a person needs to approve an action, but the Mac may not be in front of you. **The outcome:** Approval requests reach the Chrome Relay Approve app on your iPhone, and you approve them with Face ID. ### Steps 1. Complete the Mac setup with `./build` and `./chrome-relay setup` 2. Install TestFlight on the iPhone, then open the Chrome Relay Approve link there: https://testflight.apple.com/join/zhpm8gND 3. Install the Chrome Relay Approve app from TestFlight on the iPhone 4. Run an agent task that needs approval, and approve it on the phone with Face ID ### Prompt to paste into your agent ```text Using the Chrome Relay repo at aindeev/agent-chrome-relay, start a browser task on that needs approval, and wait for the approval on the iPhone app. Expected output: the approval result. Verify that the request shows the page you expect before approving. ``` ### Caveat The iPhone app is on TestFlight and was still in App Store review according to the README, so availability may change. 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/aindeev-agent-chrome-relay/approve-agent-browser-actions-from-iphone/