Skip to content
Hydra

Hydra for Chrome and Firefox

The extension (hydra-ext) lets the chat read web pages through your browser, with your logins, from your network. Install it once. It stays connected in the background as long as the browser is open.

Install

Download it from Devices → Get the companion in Hydra.

Chrome, Edge, Brave

  1. Unzip hydra-ext-chrome-....zip.
  2. Open chrome://extensions, turn on Developer mode (top right), click Load unpacked, and pick the unzipped folder.
  3. Pin the Hydra icon if you like; its badge shows on when it is connected.

Firefox

  1. Unzip hydra-ext-firefox-....zip.
  2. Open about:debugging#/runtime/this-firefox, click Load Temporary Add-on, and pick manifest.json in the unzipped folder.
  3. If the options page shows Allow access to all sites, click it. Without it Firefox lets the extension read nothing.

Firefox removes a temporary add-on when it restarts, until the add-on is signed. Firefox Developer Edition can keep it: set xpinstall.signatures.required to false in about:config.

Pair it with your account

  1. Open the extension's options (click its icon). Hydra's address is filled in.
  2. Click Pair. A Hydra tab opens at the approval page and shows a code such as FMB6-FBTT.
  3. Check that the device named there is this browser, then click Approve.

The options page then says Connected, and the device appears under Devices.

Check which account it is paired to

The extension acts for one Hydra account: the person who approved it. Look in any of three places:

  • Options page: under the status it says Paired to name (email).
  • Toolbar icon: hover it; the tooltip says Hydra: connected as your email.
  • Activity overlay: the header says Hydra · reading for your first name. It shows the first name only, because the panel appears on other people's websites.

If it shows someone else, Revoke it in Devices and pair again.

What it does, and what it never does

  • It reads a page only when your chat asks for one. A colleague's chat can never use your browser.
  • It reads with your cookies, so pages you are signed in to work, but it only reads. It never fills forms, clicks or buys.
  • It refuses private addresses (your router, localhost, *.local) and Hydra itself.
  • It never sends your cookies or passwords to Hydra. Only the page it was asked for leaves your browser.
  • Pages that need JavaScript open in a background tab, muted, and close again (at most two at a time). In Chrome the tab sits in one collapsed tab group named Hydra; in Firefox it is hidden from the tab strip. Your current page stays selected, and your typing and mouse are not interrupted.

The activity overlay

While Hydra reads a page, a small panel appears in the top-right corner of the tab you are looking at. It shows why Hydra is reading (the agent's reason and your chat's title) and where the read is: Queued, Opening the site, Rendering, Sending to Hydra, then Done or Failed with the reason.

  • Move it: drag the grip at the top. Hydra remembers the place for every site. Double-click the grip to put it back.
  • Minimise: the – button shrinks it to a small bar; + opens it again.
  • Close: × hides it until the next read. It also hides by itself a few seconds after the last read ends.
  • Pause: the pause button (or Resume reading) does the same as Pause reading in the options page.
  • Turn it off: untick Show activity overlay in the options page. The toolbar badge still shows that Hydra is working.

The panel is drawn in a sealed box the website cannot read or restyle, and it never takes keyboard focus.

Acting in your Chrome, step by step (Chrome only)

On Chrome the extension can also act for the agent (browser.act): open a page in one new tab, wait, click, type, press keys, read text and take a screenshot, on the sites the request names. It always asks first. The card shows what it will do, which sites it touches, how long it takes and that it uses your screen. Nothing starts until you press Approve; Stop ends it at the next step.

Chrome shows its own "started debugging this browser" bar while it runs, and the tab closes at the end. It stops if the tab goes to a site the request did not name. It never opens Chrome's own pages, the Web Store or Google sign-in pages, and never types into or reads password and card fields. Writing rows into a Google Sheet is the first ready-made recipe.

Updates

  • Installed by your company's device management: Chrome copies pushed by policy (ExtensionInstallForcelist, with your Hydra's update address https://hydra.example.com/extension/updates.xml) update themselves.
  • Loaded unpacked: Chrome ignores the update address. Download the new zip from Devices, unzip it over the old folder and press Reload on the extension in chrome://extensions.
  • Firefox: download the new zip from Devices and load it again.

Pause or remove it

  • Pause reading in the options page: every request answers "paused", and Hydra falls back to its server.
  • The options page lists the last 50 pages it read for you.
  • Unpair in the options page, or Revoke the device in Devices. Either one disconnects it at once.