Summary

Camoufox-cli provides a command-line interface and AI agent skills for managing an anti-detect browser, primarily targeting AI agents needing consistent and spoofed web environments. It enables reliable web automation and data extraction by offering persistent browser identities, robust fingerprint spoofing, and session isolation, benefiting developers and researchers working with AI agents that interact with web content.

How It Works

The system employs a layered architecture: a user-facing CLI communicates via Unix sockets to a long-running Python daemon. This daemon, in turn, leverages Playwright to control a Firefox browser instance. Core to its anti-detect capabilities is the Camoufox C++ library, which handles low-level spoofing of browser fingerprints including canvas, WebGL, audio, screen metrics, and fonts. The daemon manages browser state, maintains a registry of accessible elements via snapshots, and supports persistent identities for stable user profiles across sessions.

Quick Start & Requirements

• Installation: Install via npm (npm install -g camoufox-cli) or pipx (pipx install camoufox-cli).
• Browser: Download the browser component using camoufox-cli install. On Linux, install system dependencies with camoufox-cli install --with-deps.
• AI Agent Integration: Add skills for agents like Claude Code, Cursor, or Codex using npx skills add Bin-Huang/camoufox-cli.
• Basic Usage: Launch a browser and navigate with camoufox-cli open https://example.com.
• Prerequisites: Node.js/npm or Python/pipx environment.

Highlighted Details

• Advanced Fingerprint Spoofing: Utilizes C++-level Camoufox for spoofing canvas, WebGL, audio, screen metrics, and fonts.
• Persistent Identities: Creates stable, reproducible browser fingerprints, OS, and locale settings across multiple launches using the --persistent flag.
• Accessibility Tree Snapshots: Captures DOM snapshots with element references (@ref) for precise targeting and interaction.
• Session Management: Supports named sessions and robust cookie import/export for isolation and state persistence.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or roadmap were found in the provided README.

Licensing & Compatibility

The project is released under the MIT license, which is permissive and generally compatible with commercial use and integration into closed-source projects.

Limitations & Caveats

The daemon automatically stops after 30 minutes of inactivity, requiring a restart for subsequent commands. While designed for AI agents, its effectiveness for complex human-like browsing patterns or specific anti-bot detection mechanisms beyond fingerprinting is not detailed. Resetting a persistent identity requires manual deletion of its profile directory.