Camoufox Cli
Drive a headless or full Camoufox browser from the terminal for scraping, form fills, and agent-driven web tasks without writing Playwright scripts by hand.
Overview
Camoufox-cli is an agent skill for the Build phase that exposes Camoufox browser control as terminal commands for navigation, snapshots, and ref-based interactions.
Install
npx skills add https://github.com/bin-huang/camoufox-cli --skill camoufox-cliWhat is this skill?
- Daemon-backed `open`, navigate, reload, and multi-session `close --all` workflow
- Accessibility-tree `snapshot` with interactive-only (`-i`) and CSS scope (`-s`) filters
- Ref-based interactions: click, fill, type, select, check, hover, and key press
- Command reference doc mirrors SKILL.md quick-start patterns for agents
Adoption & trust: 586 installs on skills.sh; 282 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need reliable web automation from an agent or script without hand-rolling browser drivers and selector soup every time.
Who is it for?
Solo builders automating authenticated or dynamic web UIs with Camoufox and terminal-first agent workflows.
Skip if: Teams that only need static HTTP APIs with no browser, or builders who cannot run a local browser daemon on their machine.
When should I use this skill?
You need terminal-driven Camoufox navigation, interactive snapshots, or @ref clicks/fills for an agent or script.
What do I get? / Deliverables
You get a consistent CLI vocabulary for open → snapshot → click/fill so agents can execute multi-step web tasks in one session.
- Executed browser session commands
- Snapshot output with @element refs for follow-up actions
Recommended Skills
Journey fit
Browser CLI tooling sits in Build when you wire agents or scripts to real sites during integration and automation work. Integrations subphase covers connecting your product or agent to external UIs and APIs; a browser CLI is the glue layer for web automation.
How it compares
Use instead of ad-hoc curl plus brittle HTML parsing when the target workflow truly requires a real browser session.
Common Questions / FAQ
Who is camoufox-cli for?
Indie developers and agent authors who automate websites via Camoufox from the shell or from coding agents like Claude Code and Cursor.
When should I use camoufox-cli?
During Build integrations when you prototype scrapers or bots; during Ship testing when you replay UI paths; and during Validate when you pull competitor or landing-page snapshots—always after you have a lawful use case for browser access.
Is camoufox-cli safe to install?
Browser automation can reach live sites and local files; review the Security Audits panel on this page and restrict network targets and secrets in your environment before granting agent shell access.
SKILL.md
READMESKILL.md - Camoufox Cli
# Command Reference Complete reference for all camoufox-cli commands. For quick start and common patterns, see SKILL.md. ## Navigation ```bash camoufox-cli open <url> # Navigate to URL (starts daemon if needed) # Auto-prepends https:// if no protocol given camoufox-cli back # Go back camoufox-cli forward # Go forward camoufox-cli reload # Reload page camoufox-cli url # Print current URL camoufox-cli title # Print page title camoufox-cli close # Close browser and stop daemon camoufox-cli close --all # Close all sessions ``` ## Snapshot (Page Analysis) ```bash camoufox-cli snapshot # Full accessibility tree camoufox-cli snapshot -i # Interactive elements only (recommended) camoufox-cli snapshot -s "#main" # Scope to CSS selector camoufox-cli snapshot -i -s "form" # Interactive + scoped ``` ## Interactions (use @refs from snapshot) ```bash camoufox-cli click @e1 # Click element camoufox-cli fill @e1 "text" # Clear and type camoufox-cli type @e1 "text" # Type without clearing (append) camoufox-cli select @e1 "value" # Select dropdown option camoufox-cli check @e1 # Toggle checkbox camoufox-cli hover @e1 # Hover over element camoufox-cli press Enter # Press key camoufox-cli press "Control+a" # Key combination ``` ## Get Information ```bash camoufox-cli text @e1 # Get element text (by ref) camoufox-cli text body # Get all page text (by CSS selector) camoufox-cli url # Get current URL camoufox-cli title # Get page title camoufox-cli eval "document.title" # Run JavaScript expression ``` ## Screenshots and PDF ```bash camoufox-cli screenshot # Screenshot to stdout (base64) camoufox-cli screenshot page.png # Save to file camoufox-cli screenshot --full p.png # Full page screenshot camoufox-cli pdf output.pdf # Save page as PDF ``` ## Scroll ```bash camoufox-cli scroll down # Scroll down 500px (default) camoufox-cli scroll up # Scroll up 500px camoufox-cli scroll down 1000 # Scroll down 1000px ``` ## Wait ```bash camoufox-cli wait @e1 # Wait for element to appear camoufox-cli wait 2000 # Wait milliseconds camoufox-cli wait --url "*/dashboard" # Wait for URL pattern ``` ## Tabs ```bash camoufox-cli tabs # List open tabs camoufox-cli switch 2 # Switch to tab by index camoufox-cli close-tab # Close current tab ``` ## Cookies ```bash camoufox-cli cookies # Dump cookies as JSON camoufox-cli cookies import file.json # Import cookies from file camoufox-cli cookies export file.json # Export cookies to file ``` ## Sessions ```bash camoufox-cli sessions # List active sessions camoufox-cli --session <name> <cmd> # Run command in named session camoufox-cli close --all # Close all sessions ``` ## JavaScript ```bash camoufox-cli eval "document.title" # Simple expression camoufox-cli eval "document.querySelectorAll('img').length" ``` For complex JavaScript with nested quotes, use shell escaping carefully or pipe via stdin. ## Setup ```bash camoufox-cli install # Download Camoufox browser camoufox-cli install --with-deps # Download browser + system libs (Linux) ``` ## Global Options ```bash camoufox-cli --session <name> ... # Isolated browser session camoufox-cli --headed ... # Show browser window (not headless) camoufox-cli --json ... # JSON output for parsing camoufox-cli --timeout <seconds> ... # Daemon idle timeout (default: 1800) camoufox-cli --persistent [path] ... # Persistent identity — reuse the same fingerprint + cookies