← Commit history
Single readme: full content in README.md; readme.html deleted
2 files changed
+75−13
README.md+67−3@@ -8,9 +8,73 @@ you**, in the browser you already work in. Cloud containers, Hydrogen Desktop, and the AD CLI reach it through the exact same `relay → adom-desktop → bridge` path they already use for pup. -> The showcase above (oscilloscope · EDA/CAD · board control, each shown running in a Chrome window the-> extension drives) covers the use cases and the per-permission justification. The rest of this README is-> the technical reference: what's new, the architecture, the verb surface, the sub-skills, and install.+## Who we are, and why this extension needs broad browser capabilities++**Adom Industries is an AI electronics-prototyping company** — a full, AI-native development environment for+the entire electronics industry, where developers everywhere build *on top of us*. Our ecosystem and our+users are continuously writing and running code: **web-based oscilloscopes, web-based EDA & CAD software, and+applications that drive and control real circuit boards** — all in the browser, all day, every day.++Because Adom is a complete **"vibe coding"** development environment — an AI assistant and a developer+building software together in real time — the Extension operates the browser the **same way a human developer+does**: open and navigate pages, read and screenshot, fill forms, click, inspect the DOM, run and debug+JavaScript, and manage tabs, windows, downloads, and the developer's own signed-in sessions. It is the **same+category of capability as the Claude browser extension** — the AI agent's hands inside your own browser,+acting only on the commands you give it.++## What it does for you++Three real apps from the Adom ecosystem — each shown running **in a Chrome window the extension drives** (note+the **"Adom driving"** badge in the toolbar) — and how it helps you get the work done.++### Web-based oscilloscope — verify an instrument UI without clicking through every iteration++You're bringing up a browser-based scope and need to confirm the trigger and timebase behave against real+signals. Instead of clicking through it by hand each pass, your AI assistant drives the live app in your own+Chrome — sets the timebase, drags the trigger to **CH1-rising**, reads the measurements back, and screenshots+the result. You stay in flow while it verifies the instrument and flags a regression the moment one appears.++### Web-based EDA & CAD — try a design change and see it routed, hands-free++Mid-design you want to try a change and see it routed. Your AI opens the EDA tool in the browser you're+already signed into, **fills the schematic, re-runs the autorouter, and inspects the nets** — turning "try this+and tell me what breaks" into something it just does, in the same session where your part libraries and logins+already live.++### Apps that drive real circuit boards — hardware-in-the-loop in your actual session++When a board-control app talks to real hardware, the AI needs your **actual** browser — your device session,+your USB permissions, your dashboard login. The Extension gives it exactly that: it drives the live page,+flashes and operates the board, and reports back — so hardware-in-the-loop testing runs hands-free instead of+you babysitting every flash.++## Every permission, justified++A development environment has to operate the browser the way a developer does. Each permission maps to a+concrete action you ask for — to deliver the features above, never to collect data.++| Permission | What the user-requested feature needs it for |+|---|---|+| `debugger` | Drive, inspect, screenshot, and **debug the live page** via the DevTools protocol — exactly what building and testing a web app requires. Attached only while a command runs, detached when idle. |+| `host: <all_urls>` | A dev environment must work on **whatever app you're building or testing** — there's no fixed allow-list for "the whole web." Exercised only per command, never to crawl. |+| `cookies` | Use your **existing signed-in dev tools and services** without forcing a re-login. Used to perform your task, never collected. |+| `nativeMessaging` | The core transport — connects the extension to **your local Adom Desktop** so your AI session can send commands and receive results. |+| `tabs` · `scripting` · `webNavigation` | Open/switch/reload the tabs you operate, read the DOM and fill fields, and run each command at the right moment (e.g. "navigate, then screenshot"). |+| `downloads` | Save files you ask to download — exports, CAD/3D assets, datasheets — into your own profile. |+| `tabCapture` · `desktopCapture` | Record a walkthrough of **your own page** when you explicitly ask for one. |+| `storage` · `alarms` | Remember your session-to-window map and keep the connection alive — minimal local state only. |++**No remotely-hosted code.** All logic ships in the package; it evaluates JavaScript only on the page you+point it at, via the debugger/scripting APIs — never by loading external scripts.++## You're always in control++- **It acts only on your command** — every action is initiated by you, or by your Adom session working on your behalf.+- **It's visible when it's driving** — Chrome's *"started debugging this browser"* bar appears whenever a+ debugger-using command runs; the extension lazy-attaches and idle-detaches after a few seconds, so the bar is+ only up while it's actually working.+- **Idle by default** — it does nothing unless your Adom Desktop and an Adom session are connected, and you can+ remove it at any time to end all access. ## What's new
package.json+8−10@@ -13,24 +13,22 @@ "package.json", "page.json", "README.md",- "readme.html", "skills/cross-platform-dev/SKILL.md", "skills/driving-the-extension/SKILL.md", "skills/driving-the-extension-demo/SKILL.md", "skills/driving-the-desktop/SKILL.md",- "screenshots/hero-v4.png",- "screenshots/demo-login.png",- "screenshots/demo-fetch.png",- "screenshots/show-snapmagic-login.png",- "screenshots/show-snapmagic-in.png",- "screenshots/show-digikey.png",- "screenshots/show-ti.png",- "screenshots/show-captcha.png", "demo/adom-native-browser-demo.mp4", "host/native-host.js", "bridge/server.js", "skills/driving-sites/SKILL.md",- "skills/driving-gusto/SKILL.md"+ "skills/driving-gusto/SKILL.md",+ "skills/reading-google-messages/SKILL.md",+ "screenshots/hero-v5.png",+ "screenshots/usecase-oscilloscope.png",+ "screenshots/usecase-eda.png",+ "screenshots/usecase-board.png",+ "PRIVACY.md",+ "privacy.html" ], "scripts": { "install": "./install.sh",