aindeev / agent-chrome-relay

# Chrome Relay
Lets your coding agents (Claude Code, Codex, Cursor, Paseo, pi) use **your everyday Chrome**, with your real
logins, from the command line, **in background tabs**: nothing takes focus, nothing on your screen moves.
- **Whole goals in one command.** `chrome-relay do "Invite the new teammate as an admin" --data "Email=ada@example.com"
 --until "text:Invitation sent"` fills, clicks and checks every step, in about the time an agent spends on one
 click. More
- **Or step by step**, with checked commands that answer in tens of milliseconds (`open`, `snapshot`, `click`,
 `fill`). More
- **Sign-ins without you.** Google account hops are clicked through; other logins come from the 1Password vaults
 you share with it (passwords, 2-step codes, passkeys), typed by Chrome Relay so the agent never sees them.
 More
- **Approvals on your iPhone** when you're away from the Mac, with Face ID. More
- **An audit trail** of everything every agent did. More
**Status**
- **Mac service:** built from source on your Mac (Setup, about 2 minutes).
- **Chrome extension:** in the Chrome Web Store
 (unlisted: only at that link).
- **iPhone app**, Chrome Relay Approve: on TestFlight (install
 TestFlight on the iPhone, then open the link there); in App Store review.
- **Password managers:** 1Password only, for now.
**The core** is background tabs with your logins, `chrome-relay do`, Google sign-in hops and an audit trail.
**Everything else is optional** and off until you turn it on: 1Password, Secure Enclave passkeys, iPhone
approvals, and a TypeSafe key for the fastest decider. See What's optional. Nothing installs
the extension for you, and it only runs on Macs whose owner set it up.
## How it works
 [code] 
- **Extension** (`extension/`, MV3, one per Chrome profile you load it in): opens each agent tab **inactive**
 in a collapsed "Agents" tab group and runs DevTools commands in it via `chrome.debugger`. No remote-debugging
 port, so Chrome never shows "Allow remote debugging?". Chrome does show "Chrome Relay started debugging this
 browser" while agents work.
- **`chrome-relay`**: one Go program, **built and signed on your own Mac** (`./build`). As a background service
 (`chrome-relay serve`) it is the relay: a DevTools endpoint per agent, where each agent sees and controls only
 the tabs it opened and commands that could raise or focus the browser are swallowed. It is also the CLI
 (setup, the connection URL, `do`, diagnostics, audit trail), and the optional 1Password vault and passkeys, whose
 Secure Enclave and Touch ID code (`internal/macos`, Swift) is linked into the same signed binary when Xcode's
 command line tools are installed.
## Setup (once per Mac, ~2 minutes)
Fastest: paste this prompt into Claude Code, Codex or
Cursor in its auto mode (Claude Code: Shift+Tab, or `claude --permission-mode auto`; Codex:
`--full-auto`) and let your agent do it. You only load the extension and approve in 1Password. By hand:
Needs macOS, Google Chrome and Go 1.25+ (`