Skip to content

Claude Code plugin

The REL plugin connects Claude Code to REL’s persistent embedded Chromium sessions. It configures the MCP server bundled with the installed app and adds the namespaced /rel:rel-browser skill for interactive browser work plus /rel:crawl-websites-with-rel for restartable, history-preserving crawls.

Related documents: MCP server, browser diagnostics, session scope and CLI.

The plugin bundles a site-specific skills collection in plugins/rel/skills/:

Skill Domain Guidance
rel-reddit reddit.com Login, private cookie export, fresh-cookie Session creation, bounded 429 recovery, and configured rotating routes
rel-zillow zillow.com Profile settings, geographic filters, maps, and property details
rel-craigslist craigslist.org Regional searches, category scope, postings, and expiry
rel-google google.com Search Native identity, direct routing, query scope, and source verification
rel-x x.com, twitter.com Login snapshots, search tabs, timelines, and thread coverage
rel-duckduckgo duckduckgo.com Regional search, result expansion, and source links
rel-loopnet loopnet.com Commercial-property filters, units, and gated details

These skills load for their own domains and are available to both plugin hosts. Their setup guidance comes from local REL.app Profiles inspected on 2026-10-27; the plugin does not install those Profiles or ship proxy aliases, credentials, or cookie files. Discover current Profiles before creating a Session. RYM, AOTY, Metacritic, and Discogs are excluded from this collection.

Reddit’s fresh-cookie and rotating-route workflow is specific to Reddit. It honors rate-limit waits and bounds replacement attempts; it cannot guarantee access. Cookie-file selection is currently an app workflow, not a CLI/MCP creation option, and REL has no public Session reset API. See cookie files and Session scope.

  • macOS 15 or later;
  • REL 0.1.156 or later installed on the Mac, with the Project/Session MCP adapter;
  • a current Claude Code release with plugin marketplace support.

The launcher requires adapter version 0.1.156 or later and the rel-project-sessions-v1 API contract. An unsupported adapter stops with an update instruction before exposing tools. Operational calls reject older local runtimes as well. Restart the MCP connection after updating the plugin or app.

REL.app must be installed so Claude Code can start its bundled Contents/Resources/rel-mcp adapter. The app does not need to be running for plugin discovery or rel_status; other validated tool calls start it lazily.

The plugin checks /Applications/REL.app, ~/Applications/REL.app, then macOS application registration using bundle ID me.rel.Rel. Set REL_APP_PATH in the MCP host’s environment to select a custom bundle path. Discovery does not launch REL; an invalid override reports an error without falling back.

Add this repository as a Claude Code marketplace, then install the rel plugin:

Terminal window
claude plugin marketplace add rel-me/rel-tools
claude plugin install rel@rel

Restart Claude Code after installation. If an interactive installation asks for MCP approval or reports that a reload is required, approve the local REL server and run /reload-plugins.

The plugin contains:

  • the bundled REL MCP server configuration, with automatic app discovery;
  • the namespaced /rel:rel-browser skill for safe session selection and browser workflows;
  • the namespaced /rel:crawl-websites-with-rel skill for rendered-link discovery, readiness, checkpoints, capture metadata, bounded retries, and session recovery;
  • the app-bundled MCP tools, including bounded semantic reading, opt-in untrusted website notifications, observations, session traces, non-blocking debug state, optional diagnostic bundles, and inline or file-backed screenshots;
  • all eight canonical page actions: click, wait-for, type, clear, press, select, wait, and click-link.

The plugin does not add another browser backend. REL.app remains the only Chromium owner, and every tool call flows through the local versioned API. See the MCP tool reference for complete inputs and action semantics.

Begin with a read-only check after restarting or reloading plugins:

Use the REL MCP server. Call rel_status, then rel_list_sessions. Do not navigate anywhere.

Claude Code should discover the REL MCP tools supplied by the installed app without opening REL. If REL is already running, rel_status reports the app, local agent, Browser Proxy, and embedded Chromium bridge. Otherwise it returns the local connection error without launching the app; rel_list_sessions then starts REL lazily.

While a selected Session is waiting or after it fails, use rel_debug_state and rel_session_trace with its exact ID. Preserve the original error details and snapshot age before retrying or replacing the Session. Use rel_debug_bundle for a bounded shareable artifact; HTML and screenshots default to off.

Select a Project with rel_list_projects, then inspect its Sessions with rel_list_sessions({"project_id":"ProjectDefault"}). To create independent browser state, use rel_create_session with project_id and optional profile; reuse the returned session_id. A Profile name never identifies a live login. Use rel_close_session for one exact Session when the workflow owns cleanup.

Update the installed plugin, then restart Claude Code to apply it:

Terminal window
claude plugin update rel@rel

The Codex and Claude Code packages share a plugin version, independent of the REL app version. Regular app promotion checks the plugin directory and both marketplace manifests. When their contents have changed since the last plugin version bump, promotion tests the launcher and publishes a synchronized patch bump on this repository’s main. Unchanged plugin contents keep their version; app-bundled MCP updates alone do not require a plugin release. Staging and Beta releases do not update the shared marketplaces.

Marketplace publication does not refresh an already installed plugin cache. Use the update commands above and restart or reload the client as directed.