Choose the right Interceptor surface. Use interceptor-browser for page DOM, network, browser tabs, rich editors, screenshots, and browser automation. Use interceptor-macos for native apps, browser chrome, URL bars, OS dialogs, cross-app routing, AX trees, native screenshots, Apple Events, trusted OS input, macOS Electron CDP/app web-content control, and in-process app runtime control. Use interceptor-ios for apps on an owned, unlocked, Developer-Mode iPhone. Use interceptor-research for deep multi-source web research. Background-first by default; focus changes require explicit opt-in.
npx skills add https://github.com/Hacker-Valley-Media/Interceptor --skill interceptor
Use this as the routing skill before loading a surface-specific skill.
| Task | Skill |
|---|---|
| Page DOM, text, network, SPA state, browser monitor, screenshots of browser content | interceptor-browser |
| Rich browser editors (Docs/Slides/Canva), canvas/WebGL camera viewers, scene-graph reads, page-world request overrides, blob/export capture, or "cooking" a live page with overlays/HUDs | interceptor-browser |
| Native macOS apps, OS dialogs, browser chrome, URL bars, app windows, menu bars | interceptor-macos |
| Electron / Chromium desktop app web contents, such as Slack, VS Code, Notion, or Descript DOM/network/JS | interceptor macos cdp / interceptor macos cdp app via interceptor-macos/references/cdp-app.md |
| Native app runtime internals: live view/object graph, selector calls, rendered text mutation, hooks, MapKit/AppKit/SwiftUI runtime work | interceptor macos runtime via interceptor-macos/references/native-agent.md |
| Open or control a named app such as Brave, Mail, Finder, Signal, or Cursor | interceptor-macos |
| Backgrounded, occluded, minimized, or cross-Space app capture | interceptor-macos |
| Deep web research: investigate a topic across many sources with breadth + verification | interceptor-research |
| Owned physical iPhone, app automation, runner state and device services | interceptor-ios |
| Capabilities added by an installed extension (operator-supplied) | run interceptor extensions list, then load the extension's own skill (interceptor-ext-<name>) |
interceptor tab group. Do not use --any-tab unless the user explicitly authorizes acting outside that group.INTERCEPTOR_SESSION_ID or pass a unique --group <label> to each lane. Explicit groups are hard-scoped by default unless --any-tab is authorized. Close named groups with interceptor group close <label> when done; the idle timer is based on tab activity, so metadata polls do not keep a group alive.interceptor open <url> and interceptor tab new <url> create background tabs by default. Only open --activate, tab new --activate, tab switch <id>, and window focus <id> intentionally move browser focus.interceptor macos app activate <app> and interceptor macos open <app> --activate intentionally move focus.interceptor contexts and pass --context <id>.safari; use interceptor --context safari <verb> for page content and interceptor macos for Safari chrome or native fallbacks.open, read, act, inspect) and structured reads before screenshots.interceptor macos cdp and interceptor macos cdp app are intentional app-control surfaces.interceptor macos runtime after checking interceptor status; public Full installs may require operator-supplied runtime agent dylibs/signing identity before macos runtime enable.interceptor reload --context <id>: an unpacked copy picks up the installed files; a Chrome Web Store copy only asks the store for an update and keeps its version until the store publishes the new one. interceptor contexts --verbose shows which copy (store or unpacked) and version each context runs.interceptor daemon stop and interceptor skills unadopt are install/maintenance verbs. The daemon is shared by every agent on the machine — never stop it during normal automation; the next browser command respawns it, but every connected agent's in-flight work is dropped.interceptor-browser for browser page content, network, tabs, scene graphs, and browser screenshots.interceptor-macos for native apps, browser chrome, OS dialogs, window capture, AX trees, Apple Events, Electron app CDP/app attach, and in-process native agent control.interceptor-ios for an owned, unlocked, Developer-Mode iPhone. Disconnected unlock cannot bootstrap its runner.interceptor-research for deep web research — investigating a topic across many sources with a planner loop, an on-disk source ledger, and adversarial verification (methodology layered on the browser surface). Pull the playbook any time with interceptor research.Take hacker-valley-media/interceptor from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.