Codex CloakBrowser Skill

Codex skill for stealth browser automation with CloakBrowser.

Use it when normal Playwright/Puppeteer automation may be blocked by Cloudflare, Turnstile, reCAPTCHA v3, FingerprintJS, BrowserScan, or other bot-detection systems.

This skill is script-first, not MCP-first. It gives Codex a small runner for executing CloakBrowser Python scripts in a user-local virtual environment.

Install

Copy the skill folder into your Codex skills directory:

mkdir -p ~/.codex/skills
cp -a skills/cloakbrowser ~/.codex/skills/cloakbrowser

Or from a clone:

git clone https://github.com/cagedbird043/codex-cloakbrowser-skill.git /tmp/codex-cloakbrowser-skill
mkdir -p ~/.codex/skills
cp -a /tmp/codex-cloakbrowser-skill/skills/cloakbrowser ~/.codex/skills/cloakbrowser

Dependency setup

The skill does not install system packages or global npm packages. When CloakBrowser is actually needed, run:

python3 ~/.codex/skills/cloakbrowser/scripts/cloak_run.py --setup

This creates:

~/.local/share/codex-cloakbrowser-skill/venv

and installs the cloakbrowser Python package there.

Check state:

python3 ~/.codex/skills/cloakbrowser/scripts/cloak_run.py --check

Example

Ask Codex:

Use CloakBrowser to open https://example.com and take a full-page screenshot.

Codex should write a small Python script using:

from cloakbrowser import launch

then run it through:

python3 ~/.codex/skills/cloakbrowser/scripts/cloak_run.py /tmp/cloak_task.py

Scope

This repository is not affiliated with OpenAI or CloakHQ. It packages agent instructions and a small runner around CloakBrowser for Codex-style skill workflows.

Safety

Do not use this skill for credential theft, CAPTCHA-solving services, spam, abuse, bypassing paywalls, or automating access the user is not authorized to automate. CloakBrowser reduces bot detection; it does not guarantee access.