{"slug":"oip-system-local","title":"OIP system: Mac — local shell + files","body":"## Mac — local shell + files\n\nA generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.\n\nThis page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.\n\nKind: `device`. Capabilities: `40`. Machine system map: [/api/dispatch?map=LOCAL&format=markdown](https://miscsubjects.com/api/dispatch?map=LOCAL&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### LOCAL_CAFFEINATE\nKeep Mac awake for N seconds (caffeinate -dimsu).\nUse when: \"keep my mac awake\", \"caffeinate for N seconds\", \"don't let my mac sleep\"\nArguments: `seconds`.\nHuman article: [/a/oip-capability-local-caffeinate](https://miscsubjects.com/a/oip-capability-local-caffeinate). Machine doc: [?key=LOCAL_CAFFEINATE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_CAFFEINATE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_CAFFEINATE](https://miscsubjects.com/api/invocations?object_id=LOCAL_CAFFEINATE).\n\n### LOCAL_CLIPBOARD_GET\nRead the Mac's clipboard (pbpaste).\nUse when: \"what's on my clipboard\", \"read my clipboard\", \"clipboard contents\"\nArguments: `(none)`.\nHuman article: [/a/oip-capability-local-clipboard-get](https://miscsubjects.com/a/oip-capability-local-clipboard-get). Machine doc: [?key=LOCAL_CLIPBOARD_GET&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_CLIPBOARD_GET&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_CLIPBOARD_GET](https://miscsubjects.com/api/invocations?object_id=LOCAL_CLIPBOARD_GET).\n\n### LOCAL_CLIPBOARD_SET\nPut text on the Mac's clipboard (pbcopy).\nUse when: \"copy X to my clipboard\", \"put X on my clipboard\", \"set my clipboard to\"\nArguments: `the text`.\nHuman article: [/a/oip-capability-local-clipboard-set](https://miscsubjects.com/a/oip-capability-local-clipboard-set). Machine doc: [?key=LOCAL_CLIPBOARD_SET&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_CLIPBOARD_SET&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_CLIPBOARD_SET](https://miscsubjects.com/api/invocations?object_id=LOCAL_CLIPBOARD_SET).\n\n### LOCAL_DOWNLOAD\nDownload a URL to a local path on the Mac.\nUse when: \"download X to my mac\", \"curl X to\", \"grab this URL to disk\"\nArguments: `url | path`.\nHuman article: [/a/oip-capability-local-download](https://miscsubjects.com/a/oip-capability-local-download). Machine doc: [?key=LOCAL_DOWNLOAD&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_DOWNLOAD&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_DOWNLOAD](https://miscsubjects.com/api/invocations?object_id=LOCAL_DOWNLOAD).\n\n### LOCAL_EDIT\nExact-string replace in a file (python str.replace, all occurrences). Prints count.\nUse when: \"edit X in <file>\", \"replace X with Y in <file>\", \"change <pattern> to <pattern> in\"\nArguments: `path | old | new`.\nHuman article: [/a/oip-capability-local-edit](https://miscsubjects.com/a/oip-capability-local-edit). Machine doc: [?key=LOCAL_EDIT&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_EDIT&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_EDIT](https://miscsubjects.com/api/invocations?object_id=LOCAL_EDIT).\n\n### LOCAL_EXEC\nRun a shell command on Cyrus Mac.\nUse when: any file operation, git command, system check, or script execution.\nArguments: `$1 = the shell command (pipes, &&, redirects allowed).`.\nHuman article: [/a/oip-capability-local-exec](https://miscsubjects.com/a/oip-capability-local-exec). Machine doc: [?key=LOCAL_EXEC&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_EXEC&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_EXEC](https://miscsubjects.com/api/invocations?object_id=LOCAL_EXEC).\n\n### LOCAL_GREP\nripgrep on the Mac with line numbers (50 hits per file max).\nUse when: \"grep for X in\", \"find where X is in\", \"search <pattern> in <path>\"\nArguments: `pattern | path`.\nHuman article: [/a/oip-capability-local-grep](https://miscsubjects.com/a/oip-capability-local-grep). Machine doc: [?key=LOCAL_GREP&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_GREP&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_GREP](https://miscsubjects.com/api/invocations?object_id=LOCAL_GREP).\n\n### LOCAL_HEALTH\nBridge liveness {ok, ts, installed_cli, deny_globs, ...}.\nUse when: \"is the bridge alive\", \"is my mac reachable\", \"what's installed on my mac\", \"bridge health\"\nArguments: `(none)`.\nHuman article: [/a/oip-capability-local-health](https://miscsubjects.com/a/oip-capability-local-health). Machine doc: [?key=LOCAL_HEALTH&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_HEALTH&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_HEALTH](https://miscsubjects.com/api/invocations?object_id=LOCAL_HEALTH).\n\n### LOCAL_LAUNCHD\nlaunchctl on the Mac. Inspect/restart launch agents.\nUse when: \"restart the bridge\", \"launchctl X\", \"kickstart <service>\"\nArguments: `launchctl arguments`.\nHuman article: [/a/oip-capability-local-launchd](https://miscsubjects.com/a/oip-capability-local-launchd). Machine doc: [?key=LOCAL_LAUNCHD&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_LAUNCHD&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_LAUNCHD](https://miscsubjects.com/api/invocations?object_id=LOCAL_LAUNCHD).\n\n### LOCAL_LIST\nls -la a path on the Mac.\nUse when: \"list <dir>\", \"what's in <dir>\", \"ls <path>\"\nArguments: `path (empty = home)`.\nHuman article: [/a/oip-capability-local-list](https://miscsubjects.com/a/oip-capability-local-list). Machine doc: [?key=LOCAL_LIST&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_LIST&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_LIST](https://miscsubjects.com/api/invocations?object_id=LOCAL_LIST).\n\n### LOCAL_OCR\nOCR an image (tesseract). Local path or https URL.\nUse when: \"read text from this image\", \"ocr this\", \"extract text from <image>\"\nArguments: `path or https URL`.\nHuman article: [/a/oip-capability-local-ocr](https://miscsubjects.com/a/oip-capability-local-ocr). Machine doc: [?key=LOCAL_OCR&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_OCR&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_OCR](https://miscsubjects.com/api/invocations?object_id=LOCAL_OCR).\n\n### LOCAL_OPEN\nmacOS `open` — launch an app, file, or URL on the Mac.\nUse when: \"open X on my mac\", \"launch <app>\", \"open this URL on my mac\"\nArguments: `target (URL, file path, or `-a AppName`)`.\nHuman article: [/a/oip-capability-local-open](https://miscsubjects.com/a/oip-capability-local-open). Machine doc: [?key=LOCAL_OPEN&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_OPEN&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_OPEN](https://miscsubjects.com/api/invocations?object_id=LOCAL_OPEN).\n\n### LOCAL_OSASCRIPT\nRun one line of AppleScript on the Mac (osascript -e).\nUse when: \"applescript: <line>\", \"tell <app> to <action>\", \"run osascript\"\nArguments: `the AppleScript line`.\nHuman article: [/a/oip-capability-local-osascript](https://miscsubjects.com/a/oip-capability-local-osascript). Machine doc: [?key=LOCAL_OSASCRIPT&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_OSASCRIPT&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_OSASCRIPT](https://miscsubjects.com/api/invocations?object_id=LOCAL_OSASCRIPT).\n\n### LOCAL_PORTS\nListening TCP ports on the Mac (lsof).\nUse when: \"what's listening on my mac\", \"listening ports\", \"ports in use\"\nArguments: `(none)`.\nHuman article: [/a/oip-capability-local-ports](https://miscsubjects.com/a/oip-capability-local-ports). Machine doc: [?key=LOCAL_PORTS&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_PORTS&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_PORTS](https://miscsubjects.com/api/invocations?object_id=LOCAL_PORTS).\n\n### LOCAL_PS\nRunning processes filtered by string. Empty filter = first 50.\nUse when: \"what's running on my mac\", \"is X running\", \"ps for <name>\"\nArguments: `filter (empty = first 50)`.\nHuman article: [/a/oip-capability-local-ps](https://miscsubjects.com/a/oip-capability-local-ps). Machine doc: [?key=LOCAL_PS&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_PS&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_PS](https://miscsubjects.com/api/invocations?object_id=LOCAL_PS).\n\n### LOCAL_SAY\nSpeak text aloud on the Mac (say).\nUse when: \"say X out loud\", \"speak X on my mac\", \"make my mac say\"\nArguments: `the text`.\nHuman article: [/a/oip-capability-local-say](https://miscsubjects.com/a/oip-capability-local-say). Machine doc: [?key=LOCAL_SAY&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_SAY&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_SAY](https://miscsubjects.com/api/invocations?object_id=LOCAL_SAY).\n\n### LOCAL_SCREENSHOT\nScreenshot the screen, upload to R2, return a stable URL.\nUse when: \"screenshot my mac\", \"take a screenshot\", \"what's on my screen right now\"\nArguments: `(none)`.\nHuman article: [/a/oip-capability-local-screenshot](https://miscsubjects.com/a/oip-capability-local-screenshot). Machine doc: [?key=LOCAL_SCREENSHOT&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_SCREENSHOT&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_SCREENSHOT](https://miscsubjects.com/api/invocations?object_id=LOCAL_SCREENSHOT).\n\n### LOCAL_WRITE\nOverwrite a file on the Mac. Echoes the content back.\nUse when: \"write this to <file>\", \"create <file> with\", \"drop this in <file>\"\nArguments: `path | content`.\nHuman article: [/a/oip-capability-local-write](https://miscsubjects.com/a/oip-capability-local-write). Machine doc: [?key=LOCAL_WRITE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_WRITE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_WRITE](https://miscsubjects.com/api/invocations?object_id=LOCAL_WRITE).\n\n### LOCAL_APPS\nList running GUI apps on the Mac (foreground processes).\nUse when: \"what apps are open\", \"list running apps\", \"what is running on my mac\"\nArguments: `none`.\nHuman article: [/a/oip-capability-local-apps](https://miscsubjects.com/a/oip-capability-local-apps). Machine doc: [?key=LOCAL_APPS&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_APPS&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_APPS](https://miscsubjects.com/api/invocations?object_id=LOCAL_APPS).\n\n### LOCAL_FRONTMOST\nName of the frontmost (active) app on the Mac.\nUse when: \"what app is in front\", \"what am I looking at\", \"frontmost app\"\nArguments: `none`.\nHuman article: [/a/oip-capability-local-frontmost](https://miscsubjects.com/a/oip-capability-local-frontmost). Machine doc: [?key=LOCAL_FRONTMOST&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_FRONTMOST&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_FRONTMOST](https://miscsubjects.com/api/invocations?object_id=LOCAL_FRONTMOST).\n\n### LOCAL_WINDOWS\nList window titles of the frontmost app.\nUse when: \"what windows are open\", \"list windows of the front app\"\nArguments: `none`.\nHuman article: [/a/oip-capability-local-windows](https://miscsubjects.com/a/oip-capability-local-windows). Machine doc: [?key=LOCAL_WINDOWS&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_WINDOWS&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_WINDOWS](https://miscsubjects.com/api/invocations?object_id=LOCAL_WINDOWS).\n\n### LOCAL_ACTIVATE\nBring an app to the front (focus it).\nUse when: \"open X\", \"switch to X\", \"focus X\" (X = app name)\nArguments: `app name (e.g. Safari)`.\nHuman article: [/a/oip-capability-local-activate](https://miscsubjects.com/a/oip-capability-local-activate). Machine doc: [?key=LOCAL_ACTIVATE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_ACTIVATE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_ACTIVATE](https://miscsubjects.com/api/invocations?object_id=LOCAL_ACTIVATE).\n\n### LOCAL_KEYSTROKE\nType text into the focused field on the Mac (System Events keystroke).\nUse when: \"type X\", \"enter X into the focused field\"\nArguments: `the text to type`.\nHuman article: [/a/oip-capability-local-keystroke](https://miscsubjects.com/a/oip-capability-local-keystroke). Machine doc: [?key=LOCAL_KEYSTROKE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_KEYSTROKE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_KEYSTROKE](https://miscsubjects.com/api/invocations?object_id=LOCAL_KEYSTROKE).\n\n### LOCAL_KEYCODE\nSend a macOS key code to the focused app (36=return 53=esc 48=tab 123-126=arrows).\nUse when: \"press enter\", \"hit escape\", \"press the down arrow\"\nArguments: `key code number`.\nHuman article: [/a/oip-capability-local-keycode](https://miscsubjects.com/a/oip-capability-local-keycode). Machine doc: [?key=LOCAL_KEYCODE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_KEYCODE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_KEYCODE](https://miscsubjects.com/api/invocations?object_id=LOCAL_KEYCODE).\n\n### LOCAL_UI_SNAPSHOT\nAccessibility snapshot of the frontmost window — role+name+description of each top-level UI element. Semantic, not pixels. The basis for LOCAL_UI_CLICK.\nUse when: \"what is on screen\", \"list the buttons\", \"snapshot the UI\" — run before clicking by name\nArguments: `none`.\nHuman article: [/a/oip-capability-local-ui-snapshot](https://miscsubjects.com/a/oip-capability-local-ui-snapshot). Machine doc: [?key=LOCAL_UI_SNAPSHOT&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_UI_SNAPSHOT&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_UI_SNAPSHOT](https://miscsubjects.com/api/invocations?object_id=LOCAL_UI_SNAPSHOT).\n\n### LOCAL_UI_CLICK\nClick a UI element by NAME in the frontmost app (semantic, not blind x/y). Pair with LOCAL_UI_SNAPSHOT to find names.\nUse when: \"click the X button\", \"press X\" where X is an on-screen element name\nArguments: `element name`.\nHuman article: [/a/oip-capability-local-ui-click](https://miscsubjects.com/a/oip-capability-local-ui-click). Machine doc: [?key=LOCAL_UI_CLICK&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_UI_CLICK&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_UI_CLICK](https://miscsubjects.com/api/invocations?object_id=LOCAL_UI_CLICK).\n\n### LOCAL_NOTIFY\npost a macOS Notification Center banner. ARGS: title|message|sound (optional).\nUse when: bring eyes back to the Mac when something async finishes.\nHuman article: [/a/oip-capability-local-notify](https://miscsubjects.com/a/oip-capability-local-notify). Machine doc: [?key=LOCAL_NOTIFY&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_NOTIFY&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_NOTIFY](https://miscsubjects.com/api/invocations?object_id=LOCAL_NOTIFY).\n\n### LOCAL_NETWORK\ndump current network state (Wi-Fi SSID, IP, gateway). ARGS: none.\nHuman article: [/a/oip-capability-local-network](https://miscsubjects.com/a/oip-capability-local-network). Machine doc: [?key=LOCAL_NETWORK&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_NETWORK&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_NETWORK](https://miscsubjects.com/api/invocations?object_id=LOCAL_NETWORK).\n\n### LOCAL_BATTERY\nread battery % and AC power state on the Mac. ARGS: none.\nHuman article: [/a/oip-capability-local-battery](https://miscsubjects.com/a/oip-capability-local-battery). Machine doc: [?key=LOCAL_BATTERY&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_BATTERY&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_BATTERY](https://miscsubjects.com/api/invocations?object_id=LOCAL_BATTERY).\n\n### LOCAL_FOCUS\nread current Focus mode (do not disturb / work / etc) from defaults.\nHuman article: [/a/oip-capability-local-focus](https://miscsubjects.com/a/oip-capability-local-focus). Machine doc: [?key=LOCAL_FOCUS&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_FOCUS&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_FOCUS](https://miscsubjects.com/api/invocations?object_id=LOCAL_FOCUS).\n\n### LOCAL_OPEN_URL\nopen a URL in the default browser. ARGS: $1 = url.\nHuman article: [/a/oip-capability-local-open-url](https://miscsubjects.com/a/oip-capability-local-open-url). Machine doc: [?key=LOCAL_OPEN_URL&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_OPEN_URL&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_OPEN_URL](https://miscsubjects.com/api/invocations?object_id=LOCAL_OPEN_URL).\n\n### LOCAL_OPEN_APP\nopen a macOS app by name. ARGS: $1 = app name (e.g. \"Safari\", \"Cursor\", \"Messages\").\nHuman article: [/a/oip-capability-local-open-app](https://miscsubjects.com/a/oip-capability-local-open-app). Machine doc: [?key=LOCAL_OPEN_APP&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_OPEN_APP&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_OPEN_APP](https://miscsubjects.com/api/invocations?object_id=LOCAL_OPEN_APP).\n\n### LOCAL_VOICE_RECORD\nrecord N seconds of mic to /tmp/voice-<ts>.m4a using ffmpeg, return path.\nArguments: `seconds (default 10).`.\nHuman article: [/a/oip-capability-local-voice-record](https://miscsubjects.com/a/oip-capability-local-voice-record). Machine doc: [?key=LOCAL_VOICE_RECORD&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_VOICE_RECORD&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_VOICE_RECORD](https://miscsubjects.com/api/invocations?object_id=LOCAL_VOICE_RECORD).\n\n### LOCAL_SHORTCUTS_RUN\nrun a macOS/iOS Shortcut by name (`shortcuts run \"Name\"`). ARGS: $1 = name, $2 = input (optional).\nUse when: invoke any shortcut Cyrus saved (cross-syncs with iOS).\nHuman article: [/a/oip-capability-local-shortcuts-run](https://miscsubjects.com/a/oip-capability-local-shortcuts-run). Machine doc: [?key=LOCAL_SHORTCUTS_RUN&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_SHORTCUTS_RUN&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_SHORTCUTS_RUN](https://miscsubjects.com/api/invocations?object_id=LOCAL_SHORTCUTS_RUN).\n\n### LOCAL_SHORTCUTS_LIST\nlist all Shortcuts on the Mac (`shortcuts list`).\nHuman article: [/a/oip-capability-local-shortcuts-list](https://miscsubjects.com/a/oip-capability-local-shortcuts-list). Machine doc: [?key=LOCAL_SHORTCUTS_LIST&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_SHORTCUTS_LIST&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_SHORTCUTS_LIST](https://miscsubjects.com/api/invocations?object_id=LOCAL_SHORTCUTS_LIST).\n\n### LOCAL_PASTEBOARD_PUSH_PHONE\npush text into Mac clipboard so Universal Clipboard syncs it to the iPhone. ARGS: $1 = text.\nHuman article: [/a/oip-capability-local-pasteboard-push-phone](https://miscsubjects.com/a/oip-capability-local-pasteboard-push-phone). Machine doc: [?key=LOCAL_PASTEBOARD_PUSH_PHONE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_PASTEBOARD_PUSH_PHONE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_PASTEBOARD_PUSH_PHONE](https://miscsubjects.com/api/invocations?object_id=LOCAL_PASTEBOARD_PUSH_PHONE).\n\n### LOCAL_AIRDROP\nAirDrop a file from the Mac via osascript. ARGS: $1 = absolute file path.\nHuman article: [/a/oip-capability-local-airdrop](https://miscsubjects.com/a/oip-capability-local-airdrop). Machine doc: [?key=LOCAL_AIRDROP&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_AIRDROP&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_AIRDROP](https://miscsubjects.com/api/invocations?object_id=LOCAL_AIRDROP).\n\n### LOCAL_DICTATE_TO_PHONE\nTTS the text via macOS say(1) at the Mac speakers. ARGS: $1 = text, $2 = voice (optional, default Samantha).\nHuman article: [/a/oip-capability-local-dictate-to-phone](https://miscsubjects.com/a/oip-capability-local-dictate-to-phone). Machine doc: [?key=LOCAL_DICTATE_TO_PHONE&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_DICTATE_TO_PHONE&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_DICTATE_TO_PHONE](https://miscsubjects.com/api/invocations?object_id=LOCAL_DICTATE_TO_PHONE).\n\n### LOCAL_HELP\nPrint the --help / -h / man page of a binary on the Mac. Args: binary name.\nUse when: \"how do I use X\", \"what flags does X have\", \"X --help\".\nArguments: `$1`.\nHuman article: [/a/oip-capability-local-help](https://miscsubjects.com/a/oip-capability-local-help). Machine doc: [?key=LOCAL_HELP&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_HELP&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_HELP](https://miscsubjects.com/api/invocations?object_id=LOCAL_HELP).\n\n### LOCAL_READ\nRead a file on Cyrus Mac.\nUse when: the user says \"show me\", \"read\", \"what is in\", \"display\".\nArguments: `$1 = absolute path.`.\nHuman article: [/a/oip-capability-local-read](https://miscsubjects.com/a/oip-capability-local-read). Machine doc: [?key=LOCAL_READ&format=markdown](https://miscsubjects.com/api/dispatch?key=LOCAL_READ&format=markdown). Invocation history: [/api/invocations?object_id=LOCAL_READ](https://miscsubjects.com/api/invocations?object_id=LOCAL_READ).\n","register":"oip_protocol","tags":["oip","object-invocation-protocol","protocol-specification","machine-native-json","system"],"style":{"accent":"#16324f","measure":860},"claims":[{"id":"oip-c1","tier":"system","text":"The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.","who_claims":"system/oip_articles","source_ids":["oip-s3","oip-s4"]},{"id":"oip-c2","tier":"system","text":"The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.","who_claims":"system/oip_articles","source_ids":["oip-s1"]},{"id":"oip-c3","tier":"system","text":"Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s3"]},{"id":"oip-c4","tier":"system","text":"Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.","who_claims":"system/oip_articles","source_ids":["oip-s2"]},{"id":"oip-c5","tier":"system","text":"OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s5"]}],"sources":[{"id":"oip-s1","type":"protocol","title":"BUILD_SPEC object invocation path","url":"https://miscsubjects.com/api/file/docs/BUILD_SPEC.md","summary":"Defines directory rows, dispatch, ledger, and the escalation path for changing the build.","quote":"Run anything: POST https://miscsubjects.com/api/dispatch {key, body}","claim_ids":["oip-c2"],"link_status":"ok","hash":"oipbuildspec0001"},{"id":"oip-s2","type":"protocol","title":"Object Invocation Protocol spec","url":"https://miscsubjects.com/api/file/docs/OIP.md","summary":"Defines OIP surfaces, invariant loop, receipt/replay/repair, and invocation envelopes.","quote":"identify, explain, invoke, ledger, yield","claim_ids":["oip-c3","oip-c4","oip-c5"],"link_status":"ok","hash":"oipspec00000002"},{"id":"oip-s3","type":"protocol","title":"Live OIP capability tree","url":"https://miscsubjects.com/api/dispatch?map=1&format=markdown","summary":"Public recursive capability tree.","quote":"root > shelf > system article > capability article > receipt","claim_ids":["oip-c1","oip-c3"],"link_status":"ok","hash":"oipmap0000000002"},{"id":"oip-s4","type":"protocol","title":"Directory row documentation","url":"https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown","summary":"Capability articles are generated from live rows.","quote":"Machine Contract","claim_ids":["oip-c1"],"link_status":"ok","hash":"oiprow0000000003"},{"id":"oip-s5","type":"protocol","title":"Invocation ledger","url":"https://miscsubjects.com/api/invocations","summary":"Append-only invocation records and receipt links.","quote":"invocations","claim_ids":["oip-c5"],"link_status":"ok","hash":"oipinvocations0005"}],"prov":{"model":"system/oip_articles","action":"generate"}}