firefox-cli

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:

firefox-cli -h

For contextual command help:

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:

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

For the current active page:

firefox-cli snapshot -i

For action planning:

firefox-cli snapshot -i --json

Then use the command-specific help for the next operation instead of relying on memory.

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 .