Skip to content

feat(browser)!: remove the firecrawl browser command - #375

Draft
mogery wants to merge 3 commits into
capy/cli-browser-deprecation-warningfrom
capy/remove-cli-browser-command
Draft

mogery wants to merge 3 commits into
capy/cli-browser-deprecation-warningfrom
capy/remove-cli-browser-command

Conversation

@mogery

@mogery mogery commented Nov 6, 2026 •

Copy link
Copy Markdown
Member

Stacked on #374 (the deprecation warning). Not meant to merge until the deprecation period ends.

Removes the hidden, deprecated firecrawl browser command. firecrawl scrape <url> followed by firecrawl interact covers the same workflow: open a page, then drive it with a prompt or with Playwright or agent-browser code.

  • Deletes src/commands/browser.ts (launch-session, execute, list, close and the shorthand), src/utils/browser-session.ts (the stored session file) and src/__tests__/commands/browser.test.ts.

  • Removes createBrowserCommand from src/index.ts and drops browser from the commands that require login.

  • Keeps the browser name as a hidden stub, the same way research search-github was retired. Any invocation, with any arguments or --help, prints one line to stderr and exits 1 without calling the API or asking for a login:

    Error: `firecrawl browser` was removed. Use `firecrawl scrape <url>`, then `firecrawl interact "<prompt>"` or `firecrawl interact -c "<code>"`. See `firecrawl interact --help`.
    
  • cli-argv.test.ts checks the stub for the shorthand, each former subcommand and --help.

Old browser-session.json files in the CLI config directory are left in place; nothing reads them.

How the old commands map:

Before After
firecrawl browser "open <url>" firecrawl scrape <url>
firecrawl browser "snapshot", "click @e5" firecrawl interact -c "agent-browser snapshot -i" --bash, firecrawl interact -c "agent-browser click @e5" --bash, or a prompt: firecrawl interact "Click the pricing tab"
firecrawl browser execute --python '<code>' firecrawl interact -c '<code>' --python
firecrawl browser execute --node '<code>' firecrawl interact -c '<code>'
firecrawl browser execute --bash '<cmd>' firecrawl interact -c '<cmd>' --bash
--profile <name>, --no-save-changes the same flags on firecrawl scrape
firecrawl browser close firecrawl interact stop

Open in Capy


Summary by cubic

Removes the deprecated firecrawl browser command. firecrawl scrape <url> followed by firecrawl interact covers the same workflow: open a page, then drive it with a prompt or with Playwright or agent-browser code.

The browser name stays as a hidden stub: any invocation, including --help and firecrawl help browser, prints one error line to stderr and exits 1 without calling the API or asking for a login. The command implementation, the stored-session helper, and their tests are deleted. Old browser-session.json files in the CLI config directory are left in place; nothing reads them.

Migration

  • firecrawl browser "open <url>" → firecrawl scrape <url>
  • firecrawl browser "snapshot", "click @e5" → firecrawl interact -c "agent-browser <cmd>" --bash or a prompt like firecrawl interact "Click the pricing tab"
  • firecrawl browser execute --python/--node/--bash '<code>' → firecrawl interact -c '<code>' --python (or --bash; no flag for node)
  • firecrawl browser close → firecrawl interact stop
  • --profile <name> and --no-save-changes move to firecrawl scrape

Written for commit 8ddd723. Summary will update on new commits.

View guided diff Turn on auto-fix

The hidden firecrawl browser command and its launch-session, execute,
list and close subcommands are gone, along with the stored session file
helper and their tests. firecrawl browser now prints one line that names
firecrawl scrape and firecrawl interact and exits 1 without calling the
API or asking for a login.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
@capy-ai
capy-ai Bot marked this pull request as draft November 6, 2026 17:11

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 5 files

Shadow auto-approve: would require human review. Removes the deprecated firecrawl browser command and replaces it with a stub, deleting its implementation and updating tests. Human sign-off is needed: this is a breaking CLI removal whose merge timing depends on an unverified deprecation-period end.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread src/index.ts Resolved
mogery and others added 2 commits November 6, 2026 17:15
…ning' into capy/remove-cli-browser-command

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

# Conflicts:
#	src/__tests__/cli-argv.test.ts
#	src/index.ts
Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant