git404hub

what is web-ext-run fr?

wxt-dev/web-ext-run — explained in plain English

Analysis updated 2026-07-31 · repo last pushed 2025-09-03

9JavaScriptAudience · developerComplexity · 2/5QuietLicenseSetup · moderate

tl;dr

A lightweight fork of Mozilla's web-ext tool that keeps only the ability to launch and reload a browser extension in Firefox during development. You call it from your JavaScript code to open Firefox with your extension loaded.

vibe map

mindmap
  root((repo))
    What it does
      Launches extension in Firefox
      Reloads on code changes
      JavaScript API only
    Origin
      Fork of Mozilla web-ext
      Strips build lint sign
      Lighter dependencies
    Use cases
      Extension dev tooling
      WXT integration
      Vite plugin integration
    Audience
      Tooling developers
      Extension build tool authors
    Limitations
      API may change
      No CLI included
      No linting or signing

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Add automatic Firefox launching and reloading to your own browser extension build tool.

VIBE 2

Integrate extension launch capability into a Vite-based extension development workflow.

VIBE 3

Build a custom development tool that opens Firefox with an extension loaded without pulling in unrelated dependencies.

what's the stack?

JavaScriptNode.jsFirefox

how it stacks up fr

wxt-dev/web-ext-runabivan-tech/zvec-mcpardupilot/dronecan-webtools
Stars999
LanguageJavaScriptJavaScriptJavaScript
Last pushed2025-09-032025-09-02
MaintenanceQuietQuiet
Setup difficultymoderatemoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node.js and a local Firefox installation, intended to be integrated programmatically rather than used as a standalone CLI.

This is a fork of Mozilla's web-ext tool, license terms are inherited from the original project, likely MPL-2.0 which allows free use and modification with source disclosure.

in plain english

This repo, web-ext-run, is a stripped-down fork of Mozilla's web-ext tool that keeps only the ability to launch a browser extension during development. When you are building a browser extension, you want to see your changes appear in Firefox as quickly as possible. This tool handles that, it opens Firefox with your extension loaded, and can reload it when you make changes. The original Mozilla tool it comes from is a Swiss Army knife for extension developers. It can build, lint, sign, and run extensions, among other things. But if you only need the "run" part, pulling in the full tool brings along a lot of extra baggage in the form of dependencies, other software packages it depends on. This fork cuts everything else out, leaving just the JavaScript API for launching an extension in a browser. You call it from your code, point it at your extension's source folder, and it opens Firefox with your extension ready to go. The primary audience is developers building their own tooling for browser extension development. The creator made this fork specifically for two projects: WXT and vite-plugin-web-extension, both of which are build tools that help people create extensions more easily. Those tools need a way to automatically open Firefox during development, and using the full Mozilla tool caused dependency conflicts. If you are building a similar development tool or workflow and just need the launch-and-reload capability, this is for you. If you are an individual extension developer looking for a command-line tool, you would be better served by the original Mozilla project. The notable tradeoff here is simplicity over completeness. By keeping only the run API, this fork is lighter and easier to integrate, but it gives up the linting, signing, and packaging features of the parent project. The README notes that the underlying API has limited support and may change between versions, which is worth keeping in mind if you depend on it for production tooling.

prompts (copy fr)

prompt 1
How do I use web-ext-run to open Firefox with my extension loaded from a Node.js script? Show me a basic example pointing at my extension source folder.
prompt 2
I'm building a custom dev tool for browser extensions. How can I integrate web-ext-run to launch Firefox and automatically reload the extension when my source files change?
prompt 3
What is the difference between web-ext-run and Mozilla's full web-ext tool, and why would I choose the stripped-down fork for my build tool?
prompt 4
Show me how to use the web-ext-run JavaScript API to launch a Firefox extension during development and trigger a reload programmatically.

Frequently asked questions

what is web-ext-run fr?

A lightweight fork of Mozilla's web-ext tool that keeps only the ability to launch and reload a browser extension in Firefox during development. You call it from your JavaScript code to open Firefox with your extension loaded.

What language is web-ext-run written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Firefox.

Is web-ext-run actively maintained?

Quiet — no commits in 6-12 months (last push 2025-09-03).

What license does web-ext-run use?

This is a fork of Mozilla's web-ext tool, license terms are inherited from the original project, likely MPL-2.0 which allows free use and modification with source disclosure.

How hard is web-ext-run to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is web-ext-run for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.