- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-macos -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-macos -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-macos -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-macos -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/Hacker-Valley-Media/Interceptor/tree/HEAD/.agents/skills/interceptor-macos来自发布者
Agent-operator skill for the macOS surface of Interceptor. Use the interceptor macos * CLI to drive native macOS applications: AX trees, OS-level trusted input, capture / vision / speech / NLP / Apple Events, monitor-and-replay, overlays. Use interceptor macos cdp / interceptor macos cdp app for Electron app web contents, and interceptor macos runtime for in-process native app runtime control. For content inside a browser tab load interceptor-browser instead.
The macOS bridge is a Swift daemon launched as a LaunchAgent / .app bundle. It uses Apple frameworks including Accessibility, ScreenCaptureKit, AVFoundation, Speech and Vision. Some existing capture and runtime paths also use private CGS symbols or injected runtime access. Check the surface reference and actual capability result; public framework support does not guarantee every private path works on every OS release.
This installed skill is self-contained. Source checkouts also have AGENTS.md, but packaged users may only have the skill directory below /Library/Application Support/Interceptor/skills.
Installed extensions may add capabilities under
interceptor macos <prefix> <cmd>. Each carries its own skill (interceptor-ext-<name>); this skill does not describe them. Runinterceptor extensions listto see what is installed.
interceptor status # 1. Confirm daemon + bridge are alive
interceptor macos trust # 2. Confirm TCC permissions granted
interceptor macos open "Finder" # 3. Tree + windows (background — does NOT raise Finder)
interceptor macos read # 4. AX tree + frontmost info
interceptor macos act e5 # 5. AX press of ref e5 — no focus change
interceptor macos act e3 "hello" # 6. AX value-set of ref e3 — no focus change
Treat eN refs as short-lived. AX state can change between calls; re-read before acting.
Only two commands move focus: interceptor macos app activate <app> and interceptor macos open <app> --activate. Everything else is background-first by contract — open (without --activate), all input verbs, all reads, capture, AX, menu, intent dispatch, scroll, drag, vision, overlays. If you call any other command and the user's frontmost app changes, that is a bug — file it. One opt-in asks for a permission and gives focus back: camera start --prompt shows the macOS camera prompt, then returns to the app that was in front.
The user is on this Mac too. Assume the person is working while you work. Never run either focus command to make your own work easier or to test something. Use one only when the user asks for the app to come forward, or when the action truly cannot be done in the background, and then say so first, keep it to one fast batch, and put back the frontmost app and the cursor.
What is truly foreground-only today: launching an app that is not running (it can come forward even from open without --activate, and an app updater can raise a password prompt), and a click or drag on a minimized window or hidden app. Everything else has a background route: refs, --app / --pid / --window, and interceptor click <ref> --trusted for a page in an unfocused browser window.
Full contract + verb inventory + worked examples + pitfalls: references/background-first.md.
Each workflow is a complete self-contained "you are doing X" procedure. Open the file when the task matches.
If the target is inside a browser page (DOM, network, SPA state, browser monitor, scene graph of a rich editor) - load interceptor-browser instead.
If the target is inside an Electron/Chromium desktop app's web contents (Slack, VS Code, Notion, Descript, etc.) - use references/cdp-app.md, not AX screenshots.
If the target is inside a native app's runtime (AppKit/SwiftUI object graph, selector calls, rendered text changes, hooks, MapKit state) - use references/native-agent.md. AX is still the fallback projection when the in-process agent is unavailable.
Drive native macOS apps via interceptor macos *: AX trees, background click/type/keys/drag/scroll, occluded or minimized window capture, browser chrome, URL bars, OS dialogs, Apple Events, trusted OS
---name: interceptor-macosdescription: Drive native macOS apps via interceptor macos *: AX trees, background click/type/keys/drag/scroll, occluded or…---# .agents/skills/interceptor-macos/SKILL.md概览
Drive native macOS apps via interceptor macos *: AX trees, background click/type/keys/drag/scroll, occluded or minimized window capture, browser chrome, URL bars, OS dialogs, Apple Events, trusted OS input, monitor/replay, overlays, vision, speech, NLP, JSC host utilities, Electron app web-content control via interceptor macos cdp, and in-process app runtime control via interceptor macos runtime. Background-first by contract; only app activate and open --activate move focus. Use for native apps, named browser app routing, window control, cross-app work, and system UI. Not for content inside browser pages.
常见问题
从发布者处下载 .agents/skills/interceptor-macos/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/Hacker-Valley-Media/Interceptor。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。
references/native-agent.mdIn-process native app runtime control via interceptor macos runtime |