Skip to content
Skills Library
Programming · Automation

firefox-cli

/firefox-cli

Control the user's Firefox from a terminal. Use when your task needs the user's browser or authenticated session, page navigation, tab/window control, screenshots, DOM reads, waits, or page interactions in Firefox. Do not use it as a web search replacement.

Repository
firefox-cli ↗
Licence
AGPL-3.0
Last repository change
22.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

Control the user's Firefox from a terminal. Use when your task needs the user's browser or authenticated session, page navigation, tab/window control, screenshots, DOM reads, waits, or page interactions in Firefox. Do not use it as a web search replacement.

Triggers from the description

s Firefox from a terminal. Use when your task needs the user
Original author description

Control the user's Firefox from a terminal. Use when your task needs the user's browser or authenticated session, page navigation, tab/window control, screenshots, DOM reads, waits, or page interactions in Firefox. Do not use it as a web search replacement.

How it works

  1. Command discovery
  2. Startup pattern
  3. Targeting
  4. Setup state
  5. Usage rules
Original SKILL.md headings · 76 lines, 464 words
SKILL.md preview
---
name: firefox-cli
description: Control the user's Firefox from a terminal. Use when your task needs the user's browser or authenticated session, page navigation, tab/window control, screenshots, DOM reads, waits, or page interactions in Firefox. Do not use it as a web search replacement.
---

`firefox-cli` gives agents terminal access to the user's real authenticated Firefox session through the installed Firefox extension.

## Command discovery

The CLI help is the source of truth for commands, syntax, examples, and usage guidance.

Start with:

```bash
firefox-cli -h
```

For contextual command help:

```bash
firefox-cli snapshot -h
firefox-cli tab -h
firefox-cli click -h
firefox-cli wait -h
```

Use `--json` when another program or agent consumes the output.

## Startup pattern

For a page-reading task:

```bash
firefox-cli open "https://example.com"
firefox-cli snapshot -i
```

For the current active page:

```bash
firefox-cli snapshot -i
```

For action planning:

```bash
firefox-cli snapshot -i --json
```

Use command-specific help as the reference for each next operation.

## Targeting

Omitted selectors are accepted only when the required window or tab is unique. If several windows or tabs exist, pass an ID or explicitly pass `active`.

Use only the `--window` and `--tab` flags advertised by each command. Values are `active`, an index from `firefox-cli tab` or `firefox-cli window`, or `id:<id>`.

For isolated work, create a window and target every follow-up command explicitly:

```bash
firefox-cli window new
firefox-cli open --window id:<window-id> https://example.com
firefox-cli snapshot --window id:<window-id> -i
```

`tab select` selects the tab within its window. `--focus` also requests window foregrounding. `window select` brings its window forward. For `open`, `tab new`, `window new`, and `screenshot`, `--focus` requests window foregrounding. Without it, navigation keeps tab selection unchanged, new tabs are unselected, new windows receive no foreground request, and screenshots select the target tab without raising its window. Use `--focus` when human inspection or focus-dependent rendering needs the browser in front. Pass `--window`/`--tab` explicitly to later target-dependent commands.

## Setup state
```bash
firefox-cli setup -h
firefox-cli doctor -h
```

## Usage rules

- Element refs from `snapshot -i` are useful handles for follow-up actions, but page navigation or reload can make them stale.
- Be careful with the user's data: the Firefox instance you're using contains real cookies, auth credentials, logins, tabs, and PII. Under no circumstances should you perform actions that may harm the user or exfiltrate their data. Under no circumstances should you perform payments, cash transfers, other dangerous, destructive, or irreversible operations, or leak PII without asking for the user's explicit approval before each such action.
- If you need to work with Firefox and encounter interference, such as tabs changing or real user tabs being open, open a new Firefox window for yourself. Browser actions can change tab selection or bring a window forward. Use `--focus` when the browser needs to be visible to the user.
- If the CLI denies requests with approval and asks you to run `firefox-cli connect`, invoke that **once** to show the user a permission prompt. The command will exit once approval is granted. Do not attempt to circumvent denials in any way.

Versions

The database has no other skills named firefox-cli.

Database snapshot: 13.11.2026 · package version 630cd752e0a6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100firefox-control
    Use to automate web browsing via Firefox WebDriver BiDi — tab listing, JS evaluation, screenshots, DOM helpers.
  • 100firefox
    Control Firefox browser on macOS: open URLs, close/switch tabs, get active tab info, focus Firefox, send keystrokes. Use when asked to open a link in Firefox, close a tab, switch to a tab, find what's open in Firefox, or automate any browser action.
  • 100upgrade-browser
    Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests. Use when asked to roll or upgrade Chrome or Firefox to a newer version.
  • 100firefox-extension-dev
    Reference knowledge base behind the firefox-extension-dev-agent agent. TRIGGER WHEN: any Firefox WebExtension or add-on work touching manifest.json, browser.* APIs, AMO submission or the web-ext CLI.
  • 100firefox-extension-dev
    Reference knowledge base behind the firefox-extension-dev-agent agent. TRIGGER WHEN: any Firefox WebExtension or add-on work touching manifest.json, browser.* APIs, AMO submission or the web-ext CLI.
  • 100advai-browser
    Drives browser automation with `advai browser` for navigation, DOM actions, extraction, screenshots, cookies, tabs, and network capture. Invoke when a task needs live browser interaction or web scraping.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.