Skip to main content
skill CX Codex

awawausb-webusb-firefox — Claude Code skill: WebUSB for 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.

no license 306 installs ★ 98 updated 2026-10-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-code
Open on GitHub

What awawausb-webusb-firefox 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.

What it helps with

  • 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 for the agent

  • 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.

How to install awawausb-webusb-firefox

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-code

2Manually: put the files in place

~/.claude/skills/awawausb-webusb-firefox/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/awawausb-webusb-firefox/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about awawausb-webusb-firefox

How do I install awawausb-webusb-firefox in Claude Code?

Run npx skills add reason-machines/trending-skills --skill awawausb-webusb-firefox -a claude-code; the skill lands at ~/.claude/skills/awawausb-webusb-firefox/SKILL.md.

What does this skill do?

It covers the full awawausb setup for Firefox: the add-on, the Rust native stub and the manifest that lets the two talk, plus a build from source when you need one.

Does WebUSB work in a Web Worker?

No. navigator.usb is available on the main page only, so USB calls from a worker won't run.

Similar skills

All skills for Browser and scraping →

From the same set211

The whole set →
flowdriver-covert-transport flowdriver-covert-transport routes SOCKS5 traffic through Google Drive API calls so it survives DPI and SNI filtering. Useful on networks where a normal proxy gets blocked. CX Codex +1 317installs future-agi-platform future-agi-platform — a skill that walks your coding agent through Future AGI: wiring up tracing, running eval metrics, and self-hosting the platform. CX Codex +1 315installs token-dashboard-claude-analytics token-dashboard-claude-analytics inspects session logs on your computer to map token consumption per prompt. Useful for spotting heavy prompts and managing API expenses. CX Codex +1 315installs wanman-agent-matrix wanman-agent-matrix is a Claude Code skill for setting up wanman, which coordinates Claude Code or Codex agents on a local machine. It activates for requests about launching an agent matrix or managing agents with wanman. CX Codex +1 310installs unit-3-hyprland-nier-rice unit-3-hyprland-nier-rice — an agent skill that sets up the Unit-3 rice on Arch Linux: Hyprland, Quickshell QML widgets and Waybar in a NieR:Automata style. CX Codex +1 304installs stash-ai-memory The stash-ai-memory skill guides setup of Stash, a persistent memory service for AI agents. Use it when an agent needs to retain observations and working context across sessions. CX Codex +1 299installs gpt-image-playground gpt-image-playground guides coding agents through building and deploying a React 19 web app for image generation and editing via OpenAI APIs. CX Codex +1 292installs gova-declarative-gui gova-declarative-gui teaches an agent to build native desktop apps in Go with Gova, a declarative framework where components are structs and state lives in a Scope. CX Codex +1 290installs

Project sponsors

Companies that keep this analytics open