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.

Settings, Automation page: Focus modes, monitor setups, screen sharing and during-calls options
Settings → Automation.

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.

Open these from Terminal (open "moor://next"), a browser, Alfred or any app:

LinkDoes
moor://profile/<name or id>Switch to a profile (name is case-insensitive, URL-encoded)
moor://next · moor://prevNext / previous profile
moor://toggleBack to the last profile
moor://undoUndo the last switch
moor://pickerShow the profile picker
moor://focus-offSwitch 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-docksToggle edit mode
moor://searchOpen dock search
moor://setupOpen 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

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

ActionParametersResult
Switch Moor ProfileProfile—
Next Dock Profile——
Set Moor Dock ModeMode (Apple's Dock, Custom Docks, both), Profile (optional, active one if empty)—
Save Current Dock as ProfileName—
Set Zone ModeOn—
Hide Revenue FiguresHide—
Today's Revenue—Today's totals as text
Agents Waiting for Me—Sessions that need you
Edit Docks——
Clean MemoryMode (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:

  1. Open Shortcuts → Automation → New Automation → Focus.
  2. Pick a Focus (Work, Personal, Sleep…) and When Turning On. Choose Run Immediately so it doesn't ask first.
  3. 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
FieldLimits
key1–64 letters, digits, ., _ or -
valueUp to 200 characters (a string, number or true/false)
titleOptional, up to 60 characters. Without one, the widget's own title (or the key) is used
badgeOptional whole number from 0 to 99999. 0 hides it
colorOptional: blue, purple, pink, red, orange, yellow, green, teal, graphite or #RRGGBB
symbolOptional 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:

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

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