Connect your Chrome

You finish this when the extension side panel says Connected and your browser shows up in Organization → Browsers in the console.

What you need

• Google Chrome, version 116 or later, on the computer where you are logged in to the sites the agent will use.
• An Orkestia account in the organization, or a user account in an app built on Orkestia.
• The Orkestia extension. It is not in the Chrome Web Store yet. During early access it is available on request: ask your organization admin for the install link, or contact Orkestia support.

Get a pairing code

A pairing code works once and is valid for 10 minutes. It is shown only once. Only a person can get one: an agent token asking for a code is refused.

From the console

A code from the console pairs the browser to you and to the organization.

From your AI assistant

With an assistant connected to Orkestia, ask:

Give me a code to pair my Chrome with Orkestia.

The assistant calls browser_pair with your own sign-in and shows you the code and the steps. A member gets a code for the organization. An app user gets a code for their active workspace in that app.

From an app built on Orkestia

An app can let its users pair from its own screens. The code then pairs the browser to that user and to their active workspace in the app. If the app says a workspace is required, choose one first.

Pair the extension

Check that it is online

• Console: Organization → Browsers lists each paired browser with its scope, owner, status, extension version and when it was last seen.
• Assistant: ask "List the browsers I can use and tell me which ones are online." The assistant calls browser_list.

A browser is online only while Chrome is open and the extension is connected. An agent that picks an offline browser gets BROWSER_OFFLINE.

See the sessions on a browser

In Organization → Browsers, choose Manage → View sessions on a browser. Each row shows the status (Waiting for approval, Active, Ended with the reason), the agent, its purpose, the sites, whether it may act, Ask or Full control, commands used against the limit, and when it was created, approved and closed.

Unpair a browser

Unpairing stops agents at once. Open sessions on that browser close, and its credential stops working. To use the browser again, pair it with a new code.

• In the extension: Disconnect in the side panel.
• In the console: Organization → Browsers → Manage → Unpair. An organization admin can unpair any browser. A member can unpair only the browsers they paired.
• From the API or an assistant: start browser.node.revoke with the browser's node_uuid (from browser.node.list).

Next