On this page
Automation
Everything in Moor can be driven by keyboard, links, Shortcuts and Siri — which also makes it easy for scripts and AI agents to control.

Keyboard shortcuts have their own page. To let an AI agent (Claude Code, Codex, Cursor) or a script set up your profiles, docks, themes and widgets, see MCP and API.
Links (moor://)
Open these from Terminal (open "moor://next"), a browser, Alfred or any app:
| Link | Does |
|---|---|
moor://profile/<name or id> | Switch to a profile (name is case-insensitive, URL-encoded) |
moor://next · moor://prev | Next / previous profile |
moor://toggle | Back to the last profile |
moor://undo | Undo the last switch |
moor://picker | Show the profile picker |
moor://focus-off | Switch to your “when Focus turns off” profile |
moor://mode?mode=<real|custom|both>&profile=<name> | Change a profile's Dock mode (active profile if no name) |
moor://capture?name=<name> | Save the current Dock as a new profile |
moor://edit-docks | Toggle edit mode |
moor://search | Open dock search |
moor://setup | Open the setup guide |
moor://activate?key=<key> | Activate a license key (what the Activate in Moor button after purchase uses) |
moor://widget?key=<key>&value=<value> | Update the Custom widgets showing key (optional title, badge, color, symbol; &clear=1 empties them) |
moor://theme?d=<data> | Add a shared theme (what Add to Moor on a theme link uses) |
Alfred and Stream Deck
- Alfred (5, with the Powerpack): download the Moor workflow and double-click it. Type
moorto list your profiles (the active one is marked) and press Return to switch.moor next,moor prev,moor last,moor undo,moor searchandmoor editrun those commands, andmoor save <name>saves the current Dock as a profile. - Stream Deck (Stream Deck 7.1 or later): download the Moor plugin and double-click it. Drag Switch to Profile onto a key and pick a profile; the key lights up while that profile is active. Next Profile, Previous Profile, Edit Docks and Search are there too.
Command line (moor)
Moor.app includes a moor command. To put it on your PATH, open Settings → Sync & Backup → Install Command-Line Tool…. Moor links it into /usr/local/bin if that folder is writable, or else into ~/.local/bin. It never asks for your password. If ~/.local/bin isn't on your PATH yet, the alert tells you the one line to add. If you move Moor.app, install it again.
moor list # profiles in Moor's order; * marks the active one
moor list --json # same, as JSON (id, name, mode, active, customDockIDs)
moor status # active profile, its docks, Moor's version
moor status --json
moor switch Work # by name (case-insensitive) or id
moor next | moor prev | moor last | moor undo
moor mode custom # real, custom or both; --profile <name> for another profile
moor save "Deep Work" # save the current Dock as a new profile
moor search | moor edit | moor picker
moor widget set build passing --color green --symbol checkmark.circle
moor widget set inbox 12 --badge 3 --title "Support"
moor widget clear build
moor api GET /v1/state # call the local API (see MCP and API)
moor mcp # MCP server for AI agents (see MCP and API)
moor parts # which parts are on (see Parts)
moor parts enable helm # turn a part on; disable turns it off (Docks is always on)
moor helm snap left # Helm: snap the front window; layouts, layout save|restore|delete
moor helm settings # Helm's switcher and snapping settings, as JSON
moor mast show # Mast: show the hidden menu bar items (--all for every one); hide
moor mast settings # Mast's settings; widgets lists its menu bar widgets
moor bar # Moor Bar: on or off, displays, layout and look; layout or style for one
moor bar style shape island # change one Moor Bar look setting
moor deck edit on # Deck: edit mode on or off; widgets and settings list them
moor hold open downloads # Hold: open on a shelf, or with --search "pdfs from last week"
moor hold screenshots show # Hold: fan out the screenshot stack (or clear)
moor memory # memory in use, pressure, the last clean, automatic cleaning on or off
moor memory clean # Clean: macOS asks for your password on screen; waits for the result
moor memory clean --super # Super clean: no password (from here it never quits apps)
moor memory settings # cleaning settings, as JSON
moor --version
moor help
api, mcp, parts, helm, mast, bar, deck, hold and memory talk to Moor's local API, so Moor must be running with Settings → Automation → Let apps and agents control Moor on. The part commands also need that part on. To change any part setting from a script, use moor api PATCH /v1/<part>/settings; Moor Bar's sections are moor api POST /v1/bar/sections and PATCH/DELETE /v1/bar/sections/<id>.
list and status read Moor's profiles directly, so they work even when Moor isn't running. The other commands hand Moor a moor:// link in the background (opening Moor if needed) and return right away. Bad arguments exit with status 2, and an unknown profile exits with status 1. Set MOOR_STORE_ROOT to read profiles from a different folder.
Shortcuts and Siri actions
| Action | Parameters | Result |
|---|---|---|
| Switch Moor Profile | Profile | — |
| Next Dock Profile | — | — |
| Set Moor Dock Mode | Mode (Apple's Dock, Custom Docks, both), Profile (optional, active one if empty) | — |
| Save Current Dock as Profile | Name | — |
| Set Zone Mode | On | — |
| Hide Revenue Figures | Hide | — |
| Today's Revenue | — | Today's totals as text |
| Agents Waiting for Me | — | Sessions that need you |
| Edit Docks | — | — |
| Clean Memory | Mode (Clean, Super clean) | What was freed, as text. Clean shows macOS's password prompt; it never quits apps |
Memory
Clean and Super clean (see Memory) work from Moor's menu (Clean Memory), keyboard shortcuts you set in Settings → Shortcuts → Memory, the Shortcuts action above, moor memory clean [--super], POST /v1/memory/clean and the moor_memory tool. Clean always shows macOS's administrator password prompt on screen, for you to answer; a script can't answer it. Super clean needs no password, and from automation it is only the first step: it never quits or relaunches apps. There's no moor:// link for cleaning, so a web page can't start one.
Focus
Moor's Shortcuts actions work in personal automations, so a Focus can change your Dock:
- Open Shortcuts → Automation → New Automation → Focus.
- Pick a Focus (Work, Personal, Sleep…) and When Turning On. Choose Run Immediately so it doesn't ask first.
- Add Switch Moor Profile and pick a profile. You can also add Set Moor Dock Mode or use it instead, for example to show only your Custom Docks while Work is on.
Make a second automation with When Turning Off to switch back, or pick a profile in Settings → Automation → When Focus turns off. Siri phrases work too: “Switch Moor to Work”, “Set Moor Dock mode”.
Custom widget
The Custom widget shows whatever a script sends it: a build status, a queue length, a price. Add it to a dock, open its settings and give it a key such as build. Then send values to that key. The latest value for each key is saved, so it's still there after Moor restarts.
From Terminal or a script, use the moor command:
moor widget set build passing --color green --symbol checkmark.circle
moor widget set build "3 failing" --color red --badge 3
moor widget clear build
| Field | Limits |
|---|---|
key | 1–64 letters, digits, ., _ or - |
value | Up to 200 characters (a string, number or true/false) |
title | Optional, up to 60 characters. Without one, the widget's own title (or the key) is used |
badge | Optional whole number from 0 to 99999. 0 hides it |
color | Optional: blue, purple, pink, red, orange, yellow, green, teal, graphite or #RRGGBB |
symbol | Optional SF Symbol name, like bolt.fill |
Local HTTP endpoint
For tools that can't run a command (CI runners on this Mac, Home Assistant scripts, small daemons), Moor can also take updates over HTTP. It's off by default. Turn it on in Settings → Automation → Custom widget:
- It listens on
127.0.0.1only, on port 51987 by default (you can change it). Other computers can't connect, and requests that come from web pages are refused. - Every request needs the token shown in Settings, sent as
Authorization: Bearer <token>. The token is kept in your Keychain. New Token replaces it. - Bodies over 16 KB are rejected.
TOKEN="paste the token from Settings → Automation"
# Set a value
curl -X POST http://127.0.0.1:51987/widget/build \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"value": "passing", "color": "green", "symbol": "checkmark.circle"}'
# Number value with a title and a badge
curl -X POST http://127.0.0.1:51987/widget/mrr \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"value": 12450, "title": "MRR", "badge": 2}'
# Clear it
curl -X DELETE http://127.0.0.1:51987/widget/build -H "Authorization: Bearer $TOKEN"
Moor answers {"ok":true}. On failure it answers {"ok":false,"error":"…"} with status 400 (bad body or key), 401 (missing or wrong token), 403 (wrong Host, or a request from a web page), 404, 405 or 413.
Monitor setups
Settings → Automation → Monitor setups: choose Add Current Setup with your displays arranged the way you use them, and pick a profile for it. When you connect or disconnect displays, Moor switches to the profile for that setup (or the closest saved one).
Want a profile to switch by the app in front, the time of day, a calendar event or power, as well as by displays? See Context Profiles.
Privacy and meeting modes
- Hide Revenue Figures (menu bar, Shortcuts): money widgets show ••••.
- While screen sharing in Zoom: revenue hides automatically.
- Meeting mode (Settings → Automation → During calls): when Zoom, Teams, FaceTime, Slack, WhatsApp, Discord or a browser (Meet) has used a microphone for a few seconds, Moor hides revenue, silences chat and mail badges, and holds agent alerts — until the call ends.
Zone mode
Dims everything but your working tools and silences chat badges. Turn it on from the menu bar, Shortcuts, or automatically during Focus Timer work phases.
This page as Markdown: /docs/automation.md