# fx-runner

> A node cli to control Firefox

Latest version **1.6.0** (published 2026-08-04) · MPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install fx-runner
pnpm add fx-runner
yarn add fx-runner
bun add fx-runner
```

Provides the command `fx-runner`.

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.6.0 |
| Published | 2026-08-04 |
| First published | 2015-01-22 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 53.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 15 |
| Author | Mozilla Add-ons Team |
| Maintainers | addons-robot |
| Keywords | firefox, mozilla, cli |

## Links

- npm: https://www.npmjs.com/package/fx-runner
- Repository: https://github.com/mozilla/node-fx-runner
- Homepage: https://github.com/mozilla/node-fx-runner#readme
- Issues: https://github.com/mozilla/node-fx-runner/issues
- npm.io page: https://npm.io/package/fx-runner

## Dependencies (4)

- [which](https://npm.io/package/which.md) ^4.0.0
- [winreg](https://npm.io/package/winreg.md) 0.0.12
- [commander](https://npm.io/package/commander.md) ^12.1.0
- [shell-quote](https://npm.io/package/shell-quote.md) 1.10.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.6.0 (latest) — 2026-08-04
- 1.5.0 — 2026-06-10
- 1.4.0 — 2024-01-09
- 1.3.0 — 2022-08-09
- 1.2.0 — 2021-11-23
- 1.1.0 — 2021-04-19
- 1.0.13 — 2020-07-17
- 1.0.12 — 2020-06-15
- 1.0.11 — 2019-07-18
- 1.0.10 — 2019-02-14
- 1.0.9 — 2018-05-23
- 1.0.8 — 2017-10-11
- 1.0.7 — 2017-07-11
- 1.0.6 — 2016-10-15
- 1.0.5 — 2016-07-28
- … 13 more at https://npm.io/package/fx-runner/versions

## README

# Firefox Runner

[![CircleCI](https://circleci.com/gh/mozilla/node-fx-runner.svg?style=svg)](https://circleci.com/gh/mozilla/node-fx-runner)
[![npm version](https://badge.fury.io/js/fx-runner.svg)](https://badge.fury.io/js/fx-runner)

## API

```
Usage: fx-runner [options] [command]

Commands:

start Start Firefox

Options:

-h, --help               output usage information
-V, --version            output the version number
-b, --binary <path>      Path of Firefox binary to use.
--binary-args <CMDARGS>  Pass additional arguments into Firefox.
-p, --profile <path>     Path or name of Firefox profile to use.
-v, --verbose            More verbose logging to stdout.
--new-instance           Use a new instance
--no-remote              Do not allow remote calls
--foreground             Bring Firefox to the foreground
-l, --listen <port>      Start the debugger server on a specific port.
```

### Releasing

To create a new release, do the following:

* Pull from master to make sure you're up to date.
* Bump the version in `package.json`.
* Commit and push the version change
  (or create and merge a pull request for it).
* Create a [new release](https://github.com/mozilla/fx-runner/releases/new)
  and paste in a changelog in Markdown format.
  Title the github release after the new version you just
  added in the previous commit to `package.json` (example: `1.0.4`).
* When you publish the release, github creates a tag.
  When TravisCI builds the tag,
  it will automatically publish the package to
  [npm](https://www.npmjs.com/package/fx-runner).

---
_Source: https://npm.io/package/fx-runner · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._