camoufox-cli 0.1.0__tar.gz

camoufox_cli-0.1.0/.claude/settings.local.json

@@ -0,0 +1,20 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rustc:*)",
+      "Bash(source:*)",
+      "Bash($BIN:*)",
+      "Bash(python3:*)",
+      "Bash(pip3 show:*)",
+      "Bash(cargo build:*)",
+      "Bash(pip3 list:*)",
+      "Bash(uv pip:*)",
+      "Bash(PYTHONPATH=/Users/benn/Documents/w/camoufox-cli/src /Users/benn/.local/pipx/venvs/camoufox/bin/python3:*)",
+      "Bash(/Users/benn/.local/pipx/venvs/camoufox/bin/python3:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "shadcn"
+  ]
+}

camoufox_cli-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.mypy_cache/
+
+# Node
+node_modules/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+
+# Runtime
+*.sock
+*.pid

camoufox_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bin Huang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

camoufox_cli-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: camoufox-cli
+Version: 0.1.0
+Summary: Anti-detect browser CLI for AI agents, powered by Camoufox
+Project-URL: Homepage, https://github.com/Bin-Huang/camoufox-cli
+Project-URL: Repository, https://github.com/Bin-Huang/camoufox-cli
+Project-URL: Issues, https://github.com/Bin-Huang/camoufox-cli/issues
+Author: Bin Huang
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agent,anti-detect,automation,browser,camoufox,headless
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Requires-Dist: camoufox[geoip]
+Requires-Dist: playwright
+Description-Content-Type: text/markdown
+
+# camoufox-cli
+
+Anti-detect browser CLI for AI agents, powered by [Camoufox](https://github.com/daijro/camoufox).
+
+Camoufox has C++-level fingerprint spoofing (`navigator.webdriver=false`, randomized canvas/WebGL/audio, real plugins) but only exposes a Python API. This CLI wraps it into a simple command interface optimized for AI agent tool calls — snapshot the accessibility tree, interact by ref, repeat.
+
+## Install
+
+```bash
+pipx install camoufox-cli
+```
+
+Or with pip:
+
+```bash
+pip install camoufox-cli
+```
+
+## Quick Start
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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 (base64 to stdout)
+camoufox-cli screenshot page.png          # Screenshot to file
+camoufox-cli screenshot --full page.png   # Full page screenshot
+```
+
+### Scroll & Wait
+
+```bash
+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
+
+```bash
+camoufox-cli tabs                         # List open tabs
+camoufox-cli switch 2                     # Switch to tab by index
+camoufox-cli close-tab                    # Close current tab
+```
+
+### Sessions
+
+```bash
+camoufox-cli sessions                     # List active sessions
+camoufox-cli --session work open <url>    # Use named session
+camoufox-cli close --all                  # Close all sessions
+```
+
+### Cookies
+
+```bash
+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.
+
+## License
+
+MIT

camoufox_cli-0.1.0/README.md

@@ -0,0 +1,137 @@
+# camoufox-cli
+
+Anti-detect browser CLI for AI agents, powered by [Camoufox](https://github.com/daijro/camoufox).
+
+Camoufox has C++-level fingerprint spoofing (`navigator.webdriver=false`, randomized canvas/WebGL/audio, real plugins) but only exposes a Python API. This CLI wraps it into a simple command interface optimized for AI agent tool calls — snapshot the accessibility tree, interact by ref, repeat.
+
+## Install
+
+```bash
+pipx install camoufox-cli
+```
+
+Or with pip:
+
+```bash
+pip install camoufox-cli
+```
+
+## Quick Start
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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 (base64 to stdout)
+camoufox-cli screenshot page.png          # Screenshot to file
+camoufox-cli screenshot --full page.png   # Full page screenshot
+```
+
+### Scroll & Wait
+
+```bash
+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
+
+```bash
+camoufox-cli tabs                         # List open tabs
+camoufox-cli switch 2                     # Switch to tab by index
+camoufox-cli close-tab                    # Close current tab
+```
+
+### Sessions
+
+```bash
+camoufox-cli sessions                     # List active sessions
+camoufox-cli --session work open <url>    # Use named session
+camoufox-cli close --all                  # Close all sessions
+```
+
+### Cookies
+
+```bash
+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.
+
+## License
+
+MIT