# awawausb-webusb-firefox

awawausb-webusb-firefox — a skill that walks you through putting WebUSB into Firefox: the awawausb add-on, a Rust native stub and the manifest that connects them.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 306 installs · ★ 98 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/awawausb-webusb-firefox/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/awawausb-webusb-firefox

## What it does

The skill covers awawausb, a two-piece setup that gives Firefox the `navigator.usb` object. One piece is a browser add-on shipped as `.xpi`; the other is a native stub written in Rust. They talk over native messaging, and the stub reaches the hardware through WinUSB, libusb or IOKit.

What you get is the working path. Load the add-on, then run `install.sh` on Linux or macOS, or `install.bat` on Windows. Building yourself means `cargo build --release` inside `native-stub`. A JSON manifest named `awawausb_native_stub.json` has to land in the right place: `~/.mozilla/native-messaging-hosts` on Linux, the Mozilla `NativeMessagingHosts` folder under `~/Library/Application Support` on macOS, or a registry key under `HKCU\SOFTWARE\Mozilla\NativeMessagingHosts\awawausb_native_stub` on Windows.

Two hard edges worth knowing before you start. Windows builds expect the mingw-w64 UCRT target `x86_64-pc-windows-gnullvm`, and MSVC won't work. Also `navigator.usb` is exposed on the page only — a Web Worker never sees it. Denied device access on Linux usually comes down to udev rules.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/awawausb-webusb-firefox/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/awawausb-webusb-firefox/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/awawausb-webusb-firefox/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/awawausb-webusb-firefox/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills skills/awawausb-webusb-firefox
```

2. **Manually: put the files in place**
- File: `.github/skills/awawausb-webusb-firefox/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/awawausb-webusb-firefox
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/awawausb-webusb-firefox/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/awawausb-webusb-firefox/SKILL.md

## When to use it
- get `navigator.usb` working on a Firefox page
- compile the Rust stub with `cargo build --release`
- register the native messaging manifest on macOS, Linux or Windows
- cross-build the stub for Windows with mingw-w64
- fix denied USB device access on Linux

## Example prompts
- Walk me through installing awawausb: the add-on, the native stub and the native messaging manifest.
- Build `native-stub` for Windows with `x86_64-pc-windows-gnullvm` and tell me where `awawausb_native_stub.json` goes.
- \`navigator.usb` is undefined on my page — debug the Firefox extension and stub setup for me.

## Similar
- [Firefox DevTools MCP](https://affpapa.org/en/nevibecode/mcp/firefox-devtools-mcp.md) — MCP server · ★ 578 repo stars
- [browser-extension-builder](https://affpapa.org/en/nevibecode/skills/sickn33-browser-extension-builder.md) — skill · 2100 installs
- [browser-extension-developer](https://affpapa.org/en/nevibecode/skills/browser-extension-developer.md) — skill · ★ 29370 repo stars
- [ui-regression](https://affpapa.org/en/nevibecode/skills/ui-regression.md) — skill · ★ 1216 repo stars
- [browser-stealth-agent](https://affpapa.org/en/nevibecode/skills/browser-stealth-agent.md) — skill · ★ 1298 repo stars
- [invisible_playwright_mcp](https://affpapa.org/en/nevibecode/mcp/invisible-playwright-mcp.md) — MCP server · ★ 879 repo stars

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 211 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
