obscura

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