## §OIP SYSTEM ARTICLE — MAC (12 operations)
A 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.

### Read Order
- scan operations
- open a leaf doc
- run via run_now or POST /api/dispatch
- open receipt
- repair/replay if needed

### Operations
- **MAC_HS_RUN** — Run Lua in the persistent Hammerspoon runtime on the Mac (windows, audio, bluetooth, wifi, spaces, watchers — 
  doc: https://miscsubjects.com/api/dispatch?key=MAC_HS_RUN&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_HS_RUN&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_HS_RUN
- **MAC_VM_LIST** — List Tart VMs (sandboxed macOS execution environments). ARGS: none. EX: [MAC_VM_LIST][/MAC_VM_LIST]
  doc: https://miscsubjects.com/api/dispatch?key=MAC_VM_LIST&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_VM_LIST&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_VM_LIST
- **MAC_VM_PULL** — Pull a VM image (OCI). ARGS: $1=image. EX: [MAC_VM_PULL]ghcr.io/cirruslabs/macos-sequoia-base:latest[/MAC_VM_P
  doc: https://miscsubjects.com/api/dispatch?key=MAC_VM_PULL&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_VM_PULL&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_VM_PULL
- **MAC_VM_CLONE** — Clone a VM image into a named VM. ARGS: $1=image, $2=name. EX: [MAC_VM_CLONE]ghcr.io/cirruslabs/macos-sequoia-
  doc: https://miscsubjects.com/api/dispatch?key=MAC_VM_CLONE&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_VM_CLONE&body=%3Carg1%3E%7C%3Carg2%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_VM_CLONE
- **MAC_VM_RUN** — Boot a Tart VM headless. ARGS: $1=name. NOTE: holds the call while the VM runs. EX: [MAC_VM_RUN]sandbox1[/MAC_
  doc: https://miscsubjects.com/api/dispatch?key=MAC_VM_RUN&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_VM_RUN&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_VM_RUN
- **MAC_VM_STOP** — Stop a Tart VM. ARGS: $1=name. EX: [MAC_VM_STOP]sandbox1[/MAC_VM_STOP]
  doc: https://miscsubjects.com/api/dispatch?key=MAC_VM_STOP&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_VM_STOP&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_VM_STOP
- **MAC_VM_DELETE** — Delete a Tart VM (frees disk). ARGS: $1=name. EX: [MAC_VM_DELETE]sandbox1[/MAC_VM_DELETE]
  doc: https://miscsubjects.com/api/dispatch?key=MAC_VM_DELETE&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_VM_DELETE&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_VM_DELETE
- **MAC_GUI_CLICK** — Click a UI element by Peekaboo ID (from MAC_GUI_SEE). ARGS: $1=element id. EX: [MAC_GUI_CLICK]B12[/MAC_GUI_CLI
  doc: https://miscsubjects.com/api/dispatch?key=MAC_GUI_CLICK&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_GUI_CLICK&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_GUI_CLICK
- **MAC_GUI_TYPE** — Type text into the focused field. ARGS: $1=text. EX: [MAC_GUI_TYPE]hello[/MAC_GUI_TYPE]
  doc: https://miscsubjects.com/api/dispatch?key=MAC_GUI_TYPE&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_GUI_TYPE&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_GUI_TYPE
- **MAC_GUI_SEE** — Capture the frontmost app screen + accessibility element map with clickable IDs (Peekaboo, caller-local classi
  doc: https://miscsubjects.com/api/dispatch?key=MAC_GUI_SEE&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_GUI_SEE&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_GUI_SEE
- **MAC_SAFARI_JS** — Run JavaScript in Safari's front tab and return the result. REQUIRES Safari → Develop → Allow JavaScript from 
  doc: https://miscsubjects.com/api/dispatch?key=MAC_SAFARI_JS&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_SAFARI_JS&body=%3Carg1%3E&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_SAFARI_JS
- **MAC_LOCATION** — The Mac's current location (CoreLocation; JSON lat/lon/accuracy). First run prompts for Location Services perm
  doc: https://miscsubjects.com/api/dispatch?key=MAC_LOCATION&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=MAC_LOCATION&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=MAC_LOCATION

### Troubleshooting
- If a row's example has placeholders, replace only the placeholder values and preserve separators.
- If a call fails, open its receipt and repair it with POST /api/dispatch {key, body, repairs:'inv_ID'}.
- If token scope denies this system, ask the owner for a row:/rows:/pfx: token scoped to the exact operation set.

Back to the tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown