Browser automation

Some jobs need a real browser: a dashboard behind a login, a form to fill, a page to read. UFO agents can work in two kinds of Chrome:

When your Chrome is connected, agents use it for your requests. Otherwise they use the machine's browser.

#Let agents use your own Chrome

Use this when the job needs your logins — your Search Console, your store dashboard, your email — without handing anyone a password.

#Install the UFO Browser Bridge extension

1. In UFO, open Settings → This device → Let agents use your Chrome and press Download.
2. Unzip it and keep the ufo-browser-bridge folder somewhere it can stay — Chrome runs the extension from it.
3. In Chrome, open chrome://extensions, turn on Developer mode (top right), click Load unpacked and pick that folder.

#Connect it

1. Click the UFO icon in Chrome's toolbar.
2. Switch on Let my agents use this Chrome.
3. If this Chrome isn't signed in to UFO, choose Sign in with a code. Type the code into UFO where you're already signed in on a computer — the UFO app or another browser — at Settings → This device → Connect a Chrome, and approve it.

Back in Settings → This device, the status shows Connected. Now just ask:

"Check my Search Console and tell me last week's top 5 queries."

#What it looks like while an agent works

• The agent opens its own background window in your Chrome. It doesn't take over the tab you're in or steal focus.
• The channel shows the agent's tabs, and the extension's popup lists them under Agent tabs.
• Only for requests you made. Someone else in the workspace can't make an agent use your Chrome.

#Take control back

#More than one Chrome or profile

Install the extension in each Chrome profile you want to offer — a work profile and a personal one, or Chrome on two computers. Each shows up with the account it's signed in to, so you can say which one to use:

"Use my work Chrome (me@company.com) to open the billing page."

In the popup, type a name under Agents see this Chrome as, and Workspaces that may use it limits which workspaces can reach it.

#Update the extension

When a new version is out, Settings → This device says so. Download it, replace the files in your ufo-browser-bridge folder, then press ↻ on UFO Browser Bridge in chrome://extensions — in every profile that uses that folder.

#The agents' browser on the machine

Every machine running UFO has one Chrome its agents share. Use it for sites everyone's agents need, or when you're not around.

#Sign in to a site once

Ask the agent to open the login page. When it reaches a step only a person can do — a password, a 2FA code, a CAPTCHA — it hands you the tab: finish that step and the agent carries on. The login stays for next time, for every agent on that machine.

Sitting at the machine itself, you can also do it from a terminal:

ufo browser open https://example.com/login
ufo browser tabs          # find the tab id
ufo browser focus <id>    # bring it to the front, then sign in

#Watch what an agent is doing

While an agent has a tab open, a live-view button appears in the channel. Click it to see the page as the agent sees it — and click or type into it yourself if you need to.

#Several agents at once

Each agent session has its own tabs, so two agents working at the same time don't close or navigate each other's pages.

#Send traffic through your own network

Some sites only work from a certain country or network. ufo browser proxy sets the machine's browser to go out through a proxy you choose — see the ufo command line.

#Things to ask

• "Open our App Store Connect and tell me if the review passed."
• "Fill in this form with the details from the last message."
• "Take a screenshot of the pricing page on mobile size."
• "Log in to the dashboard — I'll do the 2FA."

#Where to go next

• How do I…? — more quick answers
• Machines & the agent host — where the agents' browser lives
• UFO tools reference — the same thing from the agent's side