obscura-plugin
Skill-driven plugin for Obscura headless browser — gives AI coding agents direct access to web scraping and browser automation via slash commands.
Two approaches in Obscura:
obscura-plugin (this plugin) — skill-driven with read-only commands (obscura_fetch, obscura_scrape, etc.), designed for autonomous agent pipelines
Install
Claude Code (zero-touch)
obscura-plugin ships a .claude-plugin/ manifest. Register the marketplace source once, then install:
claude plugin marketplace add epicsagas/plugins
claude plugin install obscura-plugin
The SessionStart hook downloads obscura and obscura-worker automatically on first load. No manual steps needed.
Codex CLI
codex plugin marketplace add epicsagas/plugins
codex plugin install obscura-plugin
Skills and agents are available immediately — no further steps needed.
Antigravity
agy plugin install https://github.com/epicsagas/obscura-plugin
obscura-plugin install automatically downloads the obscura and obscura-worker binaries from Obscura releases. Linux requires glibc 2.35+ (Ubuntu 22.04+).
macOS / Linux
# pre-built binary, no Rust required
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/epicsagas/obscura-plugin/releases/latest/download/obscura-plugin-installer.sh | sh
Windows
# pre-built binary, no Rust required
irm https://github.com/epicsagas/obscura-plugin/releases/latest/download/obscura-plugin-installer.ps1 | iex
Homebrew (macOS / Linux)
brew install epicsagas/tap/obscura-plugin
Via Rust toolchain
# pre-built binary via Rust toolchain (fast)
cargo binstall obscura-plugin
# build from source (requires Rust toolchain)
cargo install obscura-plugin
obscura-plugin --version to verify. Update with brew upgrade obscura-plugin or re-run the installer script.
Register with your AI tools
After installing the binary, run obscura-plugin install to connect it to your tools:
obscura-plugin install # interactive — pick which tools
obscura-plugin install cursor # Cursor
obscura-plugin install opencode # OpenCode
obscura-plugin install cline # Cline
obscura-plugin install all # all at once
obscura-plugin uninstall cursor # remove from a specific tool
obscura-plugin list # show supported tools and status
What gets installed
| Tool | Skills | Method |
|---|
| Claude Code | plugin auto-discovers | .claude-plugin/ manifest |
| Codex CLI | plugin auto-discovers | .codex-plugin/ manifest |
| Antigravity | plugin auto-discovers | root plugin.json |
| Cursor | ~/.cursor/rules/ | obscura-plugin install |
| OpenCode | ~/.opencode/skills/ | obscura-plugin install |
| Cline | ~/.cline/skills/ | obscura-plugin install |
Skills
Registered skills are available as slash commands inside your agent:
/obscura-fetch <url> [--dump html|text|links|markdown] [--eval <js>] [--selector <css>] [--stealth]
/obscura-scrape <url1> <url2> ... [--eval <js>] [--concurrency <N>] [--format json|text]
/obscura-pipeline <index-url> # discover links → scrape in one pipeline
/obscura-crawl <seed-url> # recursive crawl with depth control, pagination, sitemap discovery
