Hypha Navigator

Let an AI agent drive your whole browser — over Hypha RPC. Tabs, navigation, DOM, screenshots, click/type by index, React, and arbitrary JavaScript on any page.

⬇ Download extension (.zip) v0.2.5 View on GitHub

MV3 · Chrome / Edge 116+ · load unpacked

What it does

🗂 Drive the browser

Open, close, switch, and navigate tabs across windows — list_tabs, open_tab, activate_tab, navigate, history.

🔎 Inspect & control pages

Smart indexed DOM, click/type by index, select, scroll, screenshots, query DOM, get HTML, and a React component tree.

⚡ Run JS anywhere

execute_script runs arbitrary JavaScript even on strict-CSP pages, via the Chrome debugger (CDP Page.setBypassCSP).

🧠 Per-site skills

The agent accumulates markdown Agent Skills bound to each site origin — it gets smarter and cheaper on every site over time.

📌 Stable target tab

Pin the tab the agent works on; keep browsing in other tabs. The pin survives the extension going to sleep.

📜 Self-documenting

Hand the agent one URL. GET /get_skill_md returns the full tool reference with curl examples.

Install

  1. Download the .zip above and unzip it somewhere permanent.
  2. Open chrome://extensions and enable Developer mode (top-right).
  3. Click Load unpacked and select the unzipped folder (the one with manifest.json).
  4. Pin the Hypha Navigator toolbar icon and click it to open the side panel.

Use it from an agent

Click Connect browser in the side panel, copy the Service URL, then:

curl "$SERVICE_URL/get_skill_md?_mode=last"          # full API + usage
curl "$SERVICE_URL/list_tabs?_mode=last"
curl -X POST "$SERVICE_URL/open_tab" -d '{"url":"https://example.com"}'
curl "$SERVICE_URL/get_browser_state?_mode=last"     # current target tab

Drive it from the command line (hyd)

Prefer a CLI over curl? The hypha-debugger pip package ships a hyd CLI (needs hypha-debugger ≥ 0.2.4 for the TLS fix). Register this browser as a profile once, then drive it with tiny commands — the same CLI also drives terminal (Python) targets. 

pipx install hypha-debugger           # or: pip install hypha-debugger
hyd profile add web "$SERVICE_URL" --type browser   # add --token <t> if protected
export HYD_PROFILE=web

hyd 'document.title'                  # bare form runs JavaScript (execute_script)
hyd js 'await fetch("/api/data").then(r=>r.json())'
hyd nav 'https://example.com'         # navigate the page
hyd shot page.png                     # save a screenshot to a PNG
hyd call get_browser_state            # call any tool by name

$SERVICE_URL is the side panel's Service URL (if you copied the get_skill_md URL, drop the trailing /get_skill_md). If hyd isn't on your PATH, use python -m hypha_debugger.cli.