← Commit history
README: 'Just say nb' sample-prompts section up top; last branding residues in docs
3 files changed
+122−2
README.md+23@@ -5,6 +5,29 @@ real, signed-in Chrome or Edge, with your cookies, SSO, saved logins, and captch comes in two layers, and the first one works the moment Bridge is installed, with nothing added to your browser at all. +## Just say "nb"++**nb** is the short name for this whole thing - use it in your prompts and your AI knows exactly+what you mean. Name a browser and profile with the `nb [browser] [profile]` pattern: "nb chrome",+"nb edge", "nb chrome work", "nb chrome personal".++Things you can say today, with nothing installed (layer 1):++> "Open the wiki in **nb**."+> "Open this signup link in **nb chrome work** so I can approve it."+> "Put the Google consent page in **nb** - I'm already signed in there."++Things you can say once the extension is in (layer 2, **nbe**):++> "Log into DigiKey in **nb** with my saved password."+> "Fill out this form in **nb** - I'm signed in already."+> "Download that datasheet in **nb**, it's behind a login."+> "Test my web app in **nb chrome** and screenshot it."++And the one that gets you from layer 1 to layer 2:++> "Install **nbe** in my Chrome."+ ## The two layers **Layer 1, nb: open your real browser. Works on day one.**
demo/demo-script.mdadded+97@@ -0,0 +1,97 @@+# Adom Native Browser Extension (nbe) - demo video script++**Audience & goal.** The primary viewer is a **Chrome Web Store / Edge Add-ons reviewer** deciding+whether to approve an extension that requests `debugger` + `<all_urls>` + `cookies` + `nativeMessaging`.+Every clip must read as: *a legitimate AI development-environment company, with real electrical-engineering+workflows, using exactly the browser capabilities those workflows require.* Tone: confident, professional,+matter-of-fact. No hype, no "hacking past" anything — just an AI doing an engineer's work in the engineer's+own browser, with the on-screen reason each capability is needed.++**Format.** Six ~30 s clips, each recorded **through the extension's own WGC recorder**+(`nbrowser_record_start {method:"wgc"}`) against a Chrome window driving the live app — proving the+recording feature on the same surface it demos. In-page captions via `nbrowser_caption`. Per-clip TTS via+`adom-tts say` (house voice). Muxed, reviewed in `video-post storyboard`, concatenated, hero'd, uploaded.++**House voice:** `en-US-AndrewMultilingualNeural`. **Per-clip target:** 28–32 s, narration ±15%.++**Recurring caption chip (bottom-left, every clip):** `Adom · AI dev environment · driving real Chrome`+**Recurring capability tag (bottom-right, per clip):** names the Chrome capability being shown + why.++---++## Clip 0 — Cold open / who we are (≈12 s, optional lead-in)+- **Caption:** "Adom — an AI development environment for electronics."+- **Narration:** "Adom is an AI development environment for the electronics industry. Engineers build and+ test web-based instruments and design tools all day — and our extension is the AI's hands inside their+ own browser. Here's what that looks like."+- **Driver:** title card / the hero, slow fade into Clip 1.++## Clip 1 — Web oscilloscope (the lead) (≈30 s)+- **Capability tag:** "chrome.debugger — drive & read a live web app"+- **Captions (sequence):**+ 1. "A real web-based oscilloscope, running in Chrome."+ 2. "The AI sets the timebase…" 3. "…drags the trigger to CH1-rising…" 4. "…and reads the measurements back."+- **Narration:** "This is a browser-based oscilloscope. Watch the assistant bring up the instrument the way+ an engineer would — it sets the timebase, drags the trigger to channel one rising, and reads the live+ measurements straight off the screen. It does this through Chrome's DevTools protocol — the same debugger+ capability a developer uses to inspect and drive a web app while building it."+- **Driver:** open scope (proxy URL) → `nbrowser` set timebase, set trigger, read VPP/FREQ → caption each beat.++## Clip 2 — Chip-fetcher: build your CAD library (≈30 s)+- **Capability tag:** "cookies + <all_urls> — your real signed-in tools"+- **Captions:** 1. "Sourcing CAD for a whole BOM." 2. "The AI drives the dashboard…" 3. "…symbol, footprint,+ 3D model, datasheet — per part." 4. "Your library, assembled."+- **Narration:** "Designing a board means sourcing CAD for every part — symbol, footprint, 3D model, and+ datasheet. The assistant drives our chip-fetcher dashboard in the engineer's own signed-in browser, working+ down the parts list and pulling each component's full bundle into the library. That's why the extension uses+ your real session and cookies — so the tools you're already logged into just work."+- **Driver:** open chip-fetcher dashboard → scroll the 71-part grid → open one chip's detail (3D + symbol ++ footprint) → caption.++## Clip 3 — Adom Symbol: schematic symbols, live (≈30 s)+- **Capability tag:** "scripting + debugger — generate & preview"+- **Captions:** 1. "A schematic symbol, generated from a datasheet." 2. "Pins grouped by function." 3. "The 3D+ package, right on the symbol." 4. "Previewed before it lands in your library."+- **Narration:** "Here the assistant generates a schematic symbol for a converter chip — reading the datasheet+ pinout, grouping the pins by function, and embedding the 3D package right on the symbol — then previews it+ live in the browser so the engineer can check it before it goes into the library."+- **Driver:** open adom-symbol live → show the ADS1262 symbol → toggle a layout option / hover a pin → caption.++## Clip 4 — Web EDA / CAD: try a change, see it routed (≈30 s)+- **Capability tag:** "debugger — drive a live design tool"+- **Captions:** 1. "A schematic, edited in the browser." 2. "Re-run the autorouter…" 3. "…inspect the nets." 4.+ "Design iteration, hands-free."+- **Narration:** "This is a browser-based EDA tool. The assistant edits the schematic, re-runs the autorouter,+ and inspects the resulting nets — turning 'try this change and tell me what breaks' into something it just+ does, in the same session where the engineer's libraries already live."+- **Driver:** open tscircuit viewer → schematic tab → trigger re-run → switch to PCB/3D → caption.++## Clip 5 — 3D board review (≈30 s)+- **Capability tag:** "debugger — inspect a live 3D view"+- **Captions:** 1. "Review the actual board in 3D." 2. "Frame the camera…" 3. "…hide a part to see the traces."+ 4. "A PCB review, in a browser tab."+- **Narration:** "Before a board ships, the engineer wants to look at the real layout. The assistant opens the+ 3D board viewer, frames the camera, and hides a component to see the traces underneath — making a PCB review+ a conversation in a browser tab instead of a context-switch into a separate desktop tool."+- **Driver:** open tscircuit 3D → orbit camera → hide a component → caption.++## Clip 6 — Adom Chipsmith: does the part fit? (≈30 s)+- **Capability tag:** "debugger — validate before fab"+- **Captions:** 1. "Does the 3D model match the footprint?" 2. "Drop the chip on its pads." 3. "Check the fit+ visually." 4. "Catch it before the PCB does."+- **Narration:** "Finally — before a part goes onto a board, its 3D model and footprint have to line up. The+ assistant drives our chip-on-pads validator to seat the chip and check the fit visually, catching a+ mis-seated or wrong-variant model before it ever reaches the PCB. Real engineering, in your real browser —+ which is exactly why Adom asks for full browser control."+- **Driver:** open chipsmith → frame the chip-on-pads → caption.++---++## Production checklist (per the demo-recording skill)+- [ ] Script approved by John ← **we are here**+- [ ] Per-clip record via `nbrowser_record_start {method:"wgc"}` (background window — non-disruptive)+- [ ] In-page captions via `nbrowser_caption` during each take+- [ ] Per-clip TTS via `adom-tts say` (house voice), muxed to `<clip>-narrated.webm`+- [ ] `video-post storyboard` review with John (mandatory gate)+- [ ] Concat → final.webm (`-g 30 -keyint_min 30` for wiki seek) → hero frame+- [ ] Upload final + hero to the wiki page; embed in README/showcase
docs/DEVELOPING.md+2−2@@ -1,4 +1,4 @@-# Fork & develop your own Adom Browser Extension+# Fork & develop your own Adom Native Browser Extension A guide for **Adom users and third parties** who want to build their own version of this extension — fork it, load it in Chrome/Edge **developer mode**, and iterate. Everything here works against the@@ -45,7 +45,7 @@ touching the one you're working in. Paste-into-Claude prompt: ```-Load my local adom-native-browser from C:\path\to\extension into Chrome via developer mode.+Load my local nb-bridge extension from C:\path\to\extension into Chrome via developer mode. ``` ## 5. The dev loop