{"_ai_door":{"see":"https://miscsubjects.com/start","note":"Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome."},"slug":"oip-system-mac","title":"OIP system: MAC","body":"## MAC\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: `core`. Capabilities: `12`. Machine system map: [/api/dispatch?map=MAC&format=markdown](https://miscsubjects.com/api/dispatch?map=MAC&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### MAC_HS_RUN\nRun Lua in the persistent Hammerspoon runtime on the Mac (windows, audio, bluetooth, wifi, spaces, watchers — privileged, no per-call prompts). ARGS: $1=Lua chunk. EX: [MAC_HS_RUN]return hs.wifi.currentNetwork()[/MAC_HS_RUN]\nHuman article: [/a/oip-capability-mac-hs-run](https://miscsubjects.com/a/oip-capability-mac-hs-run). Machine doc: [?key=MAC_HS_RUN&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_HS_RUN&format=markdown). Invocation history: [/api/invocations?object_id=MAC_HS_RUN](https://miscsubjects.com/api/invocations?object_id=MAC_HS_RUN).\n\n### MAC_VM_LIST\nList Tart VMs (sandboxed macOS execution environments). ARGS: none. EX: [MAC_VM_LIST][/MAC_VM_LIST]\nHuman article: [/a/oip-capability-mac-vm-list](https://miscsubjects.com/a/oip-capability-mac-vm-list). Machine doc: [?key=MAC_VM_LIST&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_VM_LIST&format=markdown). Invocation history: [/api/invocations?object_id=MAC_VM_LIST](https://miscsubjects.com/api/invocations?object_id=MAC_VM_LIST).\n\n### MAC_VM_PULL\nPull a VM image (OCI). ARGS: $1=image. EX: [MAC_VM_PULL]ghcr.io/cirruslabs/macos-sequoia-base:latest[/MAC_VM_PULL]\nHuman article: [/a/oip-capability-mac-vm-pull](https://miscsubjects.com/a/oip-capability-mac-vm-pull). Machine doc: [?key=MAC_VM_PULL&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_VM_PULL&format=markdown). Invocation history: [/api/invocations?object_id=MAC_VM_PULL](https://miscsubjects.com/api/invocations?object_id=MAC_VM_PULL).\n\n### MAC_VM_CLONE\nClone a VM image into a named VM. ARGS: $1=image, $2=name. EX: [MAC_VM_CLONE]ghcr.io/cirruslabs/macos-sequoia-base:latest|sandbox1[/MAC_VM_CLONE]\nHuman article: [/a/oip-capability-mac-vm-clone](https://miscsubjects.com/a/oip-capability-mac-vm-clone). Machine doc: [?key=MAC_VM_CLONE&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_VM_CLONE&format=markdown). Invocation history: [/api/invocations?object_id=MAC_VM_CLONE](https://miscsubjects.com/api/invocations?object_id=MAC_VM_CLONE).\n\n### MAC_VM_RUN\nBoot a Tart VM headless. ARGS: $1=name. NOTE: holds the call while the VM runs. EX: [MAC_VM_RUN]sandbox1[/MAC_VM_RUN]\nHuman article: [/a/oip-capability-mac-vm-run](https://miscsubjects.com/a/oip-capability-mac-vm-run). Machine doc: [?key=MAC_VM_RUN&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_VM_RUN&format=markdown). Invocation history: [/api/invocations?object_id=MAC_VM_RUN](https://miscsubjects.com/api/invocations?object_id=MAC_VM_RUN).\n\n### MAC_VM_STOP\nStop a Tart VM. ARGS: $1=name. EX: [MAC_VM_STOP]sandbox1[/MAC_VM_STOP]\nHuman article: [/a/oip-capability-mac-vm-stop](https://miscsubjects.com/a/oip-capability-mac-vm-stop). Machine doc: [?key=MAC_VM_STOP&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_VM_STOP&format=markdown). Invocation history: [/api/invocations?object_id=MAC_VM_STOP](https://miscsubjects.com/api/invocations?object_id=MAC_VM_STOP).\n\n### MAC_VM_DELETE\nDelete a Tart VM (frees disk). ARGS: $1=name. EX: [MAC_VM_DELETE]sandbox1[/MAC_VM_DELETE]\nHuman article: [/a/oip-capability-mac-vm-delete](https://miscsubjects.com/a/oip-capability-mac-vm-delete). Machine doc: [?key=MAC_VM_DELETE&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_VM_DELETE&format=markdown). Invocation history: [/api/invocations?object_id=MAC_VM_DELETE](https://miscsubjects.com/api/invocations?object_id=MAC_VM_DELETE).\n\n### MAC_GUI_CLICK\nClick a UI element by Peekaboo ID (from MAC_GUI_SEE). ARGS: $1=element id. EX: [MAC_GUI_CLICK]B12[/MAC_GUI_CLICK]\nHuman article: [/a/oip-capability-mac-gui-click](https://miscsubjects.com/a/oip-capability-mac-gui-click). Machine doc: [?key=MAC_GUI_CLICK&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_GUI_CLICK&format=markdown). Invocation history: [/api/invocations?object_id=MAC_GUI_CLICK](https://miscsubjects.com/api/invocations?object_id=MAC_GUI_CLICK).\n\n### MAC_GUI_TYPE\nType text into the focused field. ARGS: $1=text. EX: [MAC_GUI_TYPE]hello[/MAC_GUI_TYPE]\nHuman article: [/a/oip-capability-mac-gui-type](https://miscsubjects.com/a/oip-capability-mac-gui-type). Machine doc: [?key=MAC_GUI_TYPE&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_GUI_TYPE&format=markdown). Invocation history: [/api/invocations?object_id=MAC_GUI_TYPE](https://miscsubjects.com/api/invocations?object_id=MAC_GUI_TYPE).\n\n### MAC_GUI_SEE\nCapture the frontmost app screen + accessibility element map with clickable IDs (Peekaboo, caller-local classic engine — no daemon dependency). ARGS: body may carry an app override like '--app Safari'. EX: [MAC_GUI_SEE][/MAC_GUI_SEE]\nHuman article: [/a/oip-capability-mac-gui-see](https://miscsubjects.com/a/oip-capability-mac-gui-see). Machine doc: [?key=MAC_GUI_SEE&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_GUI_SEE&format=markdown). Invocation history: [/api/invocations?object_id=MAC_GUI_SEE](https://miscsubjects.com/api/invocations?object_id=MAC_GUI_SEE).\n\n### MAC_SAFARI_JS\nRun JavaScript in Safari's front tab and return the result. REQUIRES Safari → Develop → Allow JavaScript from Apple Events (owner enables once). ARGS: $1+=JavaScript source. EX: [MAC_SAFARI_JS]document.title[/MAC_SAFARI_JS]\nHuman article: [/a/oip-capability-mac-safari-js](https://miscsubjects.com/a/oip-capability-mac-safari-js). Machine doc: [?key=MAC_SAFARI_JS&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_SAFARI_JS&format=markdown). Invocation history: [/api/invocations?object_id=MAC_SAFARI_JS](https://miscsubjects.com/api/invocations?object_id=MAC_SAFARI_JS).\n\n### MAC_LOCATION\nThe Mac's current location (CoreLocation; JSON lat/lon/accuracy). First run prompts for Location Services permission. ARGS: none. EX: [MAC_LOCATION][/MAC_LOCATION]\nHuman article: [/a/oip-capability-mac-location](https://miscsubjects.com/a/oip-capability-mac-location). Machine doc: [?key=MAC_LOCATION&format=markdown](https://miscsubjects.com/api/dispatch?key=MAC_LOCATION&format=markdown). Invocation history: [/api/invocations?object_id=MAC_LOCATION](https://miscsubjects.com/api/invocations?object_id=MAC_LOCATION).\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"}}