Skip to content

Bin-Huang/camoufox-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

camoufox-cli

Anti-detect browser CLI for AI agents, powered by Camoufox.

Highlights

  • C++-level fingerprint spoofing via Camoufox (canvas, WebGL, audio, screen metrics, fonts)
  • Accessibility-tree snapshots with @ref element targeting
  • Session isolation with cookie import/export
  • Shell commands, no code generation

Works with

OpenClaw, Claude Code, Cursor, Codex, and any agent that can run shell commands.

Install

Tell your AI agent (e.g. OpenClaw):

Install this CLI and skills from https://github.com/Bin-Huang/camoufox-cli

Or install manually:

npm install -g camoufox-cli camoufox-cli install # Download browser

Or with pip:

pipx install camoufox-cli camoufox-cli install # Download browser

On Linux, install system dependencies with:

camoufox-cli install --with-deps

Agent Skill

# Add skills for AI agents (Claude Code, Cursor, Codex, etc.) npx skills add Bin-Huang/camoufox-cli

Quick Start

camoufox-cli open https://example.com # Launch browser & navigate camoufox-cli snapshot -i # Interactive elements only # - link "More information..." [ref=e1] camoufox-cli click @e1 # Click by ref camoufox-cli close # Done

Commands

Navigation

camoufox-cli open <url> # Navigate to URL (starts daemon if needed) 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

Snapshot

camoufox-cli snapshot # Full accessibility tree camoufox-cli snapshot -i # Interactive elements only camoufox-cli snapshot -s "css-selector" # Scoped to CSS selector

Output format:

- heading "Example Domain" [level=1] [ref=e1] - paragraph [ref=e2] - link "More information..." [ref=e3] 

Interaction

camoufox-cli click @e1 # Click element camoufox-cli fill @e3 "search query" # Clear + type into input camoufox-cli type @e3 "append text" # Type without clearing camoufox-cli select @e5 "option text" # Select dropdown option camoufox-cli check @e6 # Toggle checkbox camoufox-cli hover @e2 # Hover over element camoufox-cli press Enter # Press keyboard key camoufox-cli press "Control+a" # Key combination

Data Extraction

camoufox-cli text @e1 # Get text content of element camoufox-cli text body # Get all page text camoufox-cli eval "document.title" # Execute JavaScript camoufox-cli screenshot # Screenshot (JSON with base64) camoufox-cli screenshot page.png # Screenshot to file camoufox-cli screenshot --full page.png # Full page screenshot

Scroll & Wait

camoufox-cli scroll down # Scroll down 500px camoufox-cli scroll up 1000 # Scroll up 1000px camoufox-cli wait 2000 # Wait milliseconds camoufox-cli wait @e1 # Wait for element to appear camoufox-cli wait --url "*/dashboard" # Wait for URL pattern

Tabs

camoufox-cli tabs # List open tabs camoufox-cli switch 2 # Switch to tab by index camoufox-cli close-tab # Close current tab

Sessions

camoufox-cli sessions # List active sessions camoufox-cli --session work open <url> # Use named session camoufox-cli close --all # Close all sessions

Cookies

camoufox-cli cookies # Dump cookies as JSON camoufox-cli cookies import file.json # Import cookies camoufox-cli cookies export file.json # Export cookies

Flags

--session <name> Named session (default: "default") --headed Show browser window (default: headless) --timeout <seconds> Daemon idle timeout (default: 1800) --json Output as JSON --persistent <path> Use persistent browser profile directory 

Architecture

CLI (camoufox-cli) ──Unix socket──▶ Daemon (Python) ──Playwright──▶ Camoufox (Firefox) 

The CLI sends JSON commands to a long-running daemon process via Unix socket. The daemon manages the Camoufox browser instance and maintains the ref registry between commands. The daemon auto-starts on the first command and auto-stops after 30 minutes of inactivity.

Related

License

MIT

About

Anti-detect browser CLI and skills for AI agents (and humans)

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors