On this page

Widgets

Widgets sit right in your dock, next to your apps — as a single icon or a wider tile. They update on their own, and pause when the dock is hidden or your screens sleep. A click does what the widget is for, and the details are one step away (see Clicking a widget).

Live widgets in the dock.

Adding a widget

  1. Press ⌃⌥E to edit your docks.
  2. Choose Add in the toolbar, or search for the widget in the Add to your docks panel.
  3. Drag it where you want it. Widgets that need a key or a choice show Set Up — click it.

Or add one from Settings → Docks → Items → Add Widget. Most widgets come in several sizes (icon, wide, extra wide); change the size or settings by clicking the widget while editing. A dock on the left or right of the screen is one icon wide, so there wide widgets show as an icon, or stacked if the widget has a tall layout (CPU & Memory, the clocks, Focus Timer, Claude Code Usage).

Clicking a widget

A widget that has an action does it when you click. The details open from the small chevron that appears in a corner when you rest on the widget, or from right-click → Show Details. VoiceOver has a Show Details action too. A widget with no action opens its details on click.

WidgetClick does
Now PlayingPlays or pauses
Stopwatch, Focus TimerStarts or stops
ShortcutRuns the shortcut
AirDropOpens AirDrop
Audio OutputSwitches to the next sound output

A widget that needs an account says what it needs, for example Needs Stripe key · Connect. Click Connect and Settings → Accounts opens with just that account.

Time

Clock, World Clock, Focus Timer, Countdown and Time Progress widgets in a dock
Clock, World Clock, Focus Timer, Countdown and Time Progress.
WidgetShows
ClockTime and date, digital or analog
World ClockTimes in other cities, with day and night
Focus TimerWork and break phases (can turn on Zone mode while you work)
CountdownTime left until a date — a launch, a trip, a deadline
StopwatchA stopwatch
Time ProgressHow much of the day, week, month and year has gone

System

Battery, CPU and memory, Network, Disk and AirDrop widgets in a dock
Battery, CPU & Memory, Network, Disk and AirDrop.
WidgetShows
BatteryCharge, whether it's charging, and the time left, or the time until it's full
CPU & MemoryLive CPU and memory use
MemoryMemory used, memory pressure, and the apps using the most memory (more)
Audio OutputThe sound output and its volume. Click to switch to the next output. Open the details to pick one, set the volume or mute
NetworkDownload and upload speed
DiskFree space
ShortcutsA grid of your Shortcuts, one click to run
ShortcutOne shortcut's text output ("3 unread", "72°"), run on click or every 1, 5, 15 or 60 minutes
AirDropDrop files on it to share them
CustomA value your scripts send it, with an optional badge, color and symbol (how)

Memory

The Memory widget counts memory the way Activity Monitor does. Memory used is app memory, wired memory and compressed memory added together. The ring shows how much of your Mac's memory is in use. Its colour shows memory pressure: green when pressure is normal, yellow when it's high, red when it's critical. When pressure is high or critical, the widget also shows a symbol and the word High or Critical, so you don't have to rely on the colour. The extra-wide tile adds a graph of memory pressure over the last 10 minutes.

Open the details to see:

Click an app to bring it forward. Quit (the ⓧ button) asks first. The app quits only after you click Quit a second time, and it quits the same way it would with ⌘Q, so it can still ask you to save your work. Moor never force quits an app. Command-line tools are listed, but have no Quit button.

In the menu bar, the widget shows the memory used ("11.7 GB"), the percentage of memory in use ("78%"), or the memory pressure ("Normal 36%"). The symbol beside the value changes with pressure, and the words High or Critical appear when pressure isn't normal. The menu bar never shows app names.

The memory pressure percentage comes from the kernel's free-memory level, the same number the memory_pressure command prints. Moor reads memory every 2, 3 or 5 seconds, and only while the widget is on screen. It reads the apps list only while the details are open.

Clean and Super clean

macOS manages memory well on its own. It keeps files you used recently in memory (Cached Files) and gives that space back the moment an app needs it, so low free memory is normal and isn't a problem by itself. You rarely need to clean. The details have two buttons for when you want to:

While a clean you started runs (from the details, the widget's right-click menu, Moor's menu or a shortcut), a notice at the bottom of the screen shows each step until it's done, then the result. Once your password is accepted, it says Moor is emptying the file cache. Automatic cleans notify you instead, if you've turned that on.

Afterwards, the details show what was freed, in words: for example, "Freed 8.1 GB of cached files", with Cached Files before and after, and whether Compressed changed. Free memory moves by a few hundred MB a second on its own, so Moor reports under 64 MB as "Nothing to free right now", never as a negative number. Recent cleans lists the last 20.

The trade-off: cached files are there to make your apps faster. After either clean, apps may read files from disk again, which can be slower for a moment. When memory pressure is already high, macOS has already dropped most cached files, so neither clean helps much. Quitting an app you don't need is what helps.

You can also clean from the widget's right-click menu, Moor's menu (Clean Memory), a keyboard shortcut (Settings → Shortcuts → Memory, off until you choose keys), Shortcuts and Siri (Clean Memory), and automation.

Automatic cleaning

Settings → Memory sets up cleaning once for the Mac, for every Memory widget. Everything automatic is off until you turn it on.

SettingDefaultWhat it does
Clean automaticallyOffTurns on the rules below
Ask for my password so automatic cleaning can use CleanOffAutomatic Clean needs your password every time, so it shows macOS's prompt. Without this, automatic cleaning uses Super clean's first step, which needs no password
When free memory falls belowOff, 1 GBFree memory doesn't count cached files. macOS keeps it low on purpose, so this rule can fire often; the wait between cleans limits it
When memory pressure reachesOffHigh or Critical. Needs Clean, because Super clean only runs while pressure is normal
Every N hoursOff, 41 to 24 hours
Wait at least … between cleans30 minutes15 minutes to 24 hours, after any clean
Don't clean automatically: on battery, while an app is full screen, during calls and screen sharing, while nobody is using the MacAll onCalls means the camera or microphone is in use; screen sharing means a Zoom share; nobody using the Mac means no input for 5 minutes. It never cleans while the Mac is asleep
Notify me after an automatic cleanOnSays what was freed and which rule ran
Super clean's app list30 minutes, 500 MBHow long unused and how big an app must be to be listed, and apps never to list

Automatic cleaning never quits apps. While no rule is on, Moor doesn't check anything. While one is, it looks every 30 seconds.

Settingconfig keyValues
Menu bar showsbar"used" (default), "percent", "pressure"
Refresh everyrefreshSeconds2, 3 (default) or 5
Notify me when memory pressure is criticalnotifyOnCriticalfalse (default). At most one notification every 30 minutes; clicking it opens Settings → Memory

For example, to add it to the menu bar: moor api POST /v1/mast/widgets '{"kind": "system.memory", "config": {"bar": "pressure"}}'.

Revenue

Two Stripe widgets, a wide tile and an icon, showing today's sales
Stripe, wide and as an icon. Click either for today vs. yesterday and a seven-day chart.
WidgetShowsNeeds
ShopifyToday's sales and orders, vs. yesterday, 7-day chartAdmin API token (read orders)
StripeToday's volume, payments, balanceRestricted key (read Balance, Charges, Customers)
RevenueCatMRR, active subscriptions, trialsSecret API key
App StoreApp Store Connect salesApp Store Connect API key
Lemon SqueezyToday's orders and sales, vs. yesterday, 7-day chartAPI key
PaddleToday's completed transactions, vs. yesterday, 7-day chartAPI key (Paddle Billing)
GumroadToday's sales, vs. yesterday, 7-day chartAccess token
Google PlayCrash and ANR rates; daily sales from Play's sales report (a day or two behind)Service-account JSON key; your reports bucket ID for sales
Revenue SummaryEvery revenue source together—
Crypto PricesCoin prices—

More in Revenue.

Coding agents

The Agents widget showing one session working and one waiting, and the icon size with a badge
Agents: “storefront” is working, “api” needs you.
WidgetShows
AgentsYour Claude Code, Codex, Cursor, Windsurf, Gemini CLI, Aider, OpenCode and Trae sessions by project: working, needs you, or gone quiet
ProjectThe project your agents are in, one click from its editor, a terminal, Finder or GitHub
Agent DockEvery Claude Code and Codex session with its state, last line and a click to open the chat. See Coding agents
Claude Code UsageYour Claude Code tokens and cost
Dock PulseOne dot for CI, deploys, Sentry, Slack and sales: all clear, attention or alert (below)
GitHubOpen pull requests, CI state, reviews requested (needs a GitHub token)

More in Coding agents.

Dock Pulse

Dock Pulse is one dot for everything that might need you. Add the widgets you care about to a dock, add Dock Pulse, and it watches them: CI Status, Deploys, Sentry, Slack and Stripe. (The separate Vercel Deploys widget isn't watched.) It uses what those widgets already fetched, so nothing extra is requested and no extra key is needed.

DotMeans
Green tick, “All clear”Nothing needs you
Orange “!”, “Attention”New Sentry issues, unread Slack mentions or DMs, or a sale in the last ten minutes
Red cross, “Alert”The newest CI run on a main branch failed, a deploy failed in the last day, or a fatal Sentry issue

Each state has its own shape, so the dot reads without colour. Click Dock Pulse to see what needs you, worst first. Click a line to open that source: the failing run, the deploy or the Slack conversation. Readings from a widget that hasn't updated for three hours are ignored.

Failures can also notify you. Turn that off in the widget's settings (Notify me when something goes wrong). Nothing notifies in the first 30 seconds after Moor starts, and at most one notification comes every 5 minutes. Mentions and sales only show in the dot and the list. While a call holds agent alerts (see Automation), Pulse holds its notifications too. A sale's amount is left out while revenue figures are hidden.

Developer

CI status, Vercel deploys, Linear, Sentry and Docker widgets in a dock
CI Status, Vercel Deploys, Linear, Sentry and Docker.
WidgetShowsNeeds
CI StatusThe latest run per repo or workflow, green, red or running; a badge when the newest run on the main branch failsGitHub token (Actions), App Store Connect API key (Xcode Cloud), or a CircleCI token
Vercel DeploysThe latest deployment per project, its state and ageVercel token (team ID optional)
DeploysThe same for Cloudflare Pages and Workers, Netlify, Railway and Fly.ioThat service's API token (Cloudflare also needs your account ID)
SentryUnresolved issues first seen in the last 24 hours, with a badge for new onesSentry auth token and organization
LinearYour open assigned issues, in progress firstLinear personal API key
JiraYour open assigned issues, by prioritySite address, email and API token
GitHub IssuesOpen issues assigned to youGitHub token
DockerRunning containers; start, stop and restart from the popoverDocker Desktop (or another Docker engine) running

Click any row to open it in the browser.

Analytics and ads

Web analytics, ad spend and Stripe widgets in a dock
Web Analytics, Ad Spend and Stripe, side by side.
WidgetShowsNeeds
Web AnalyticsVisitors right now, and today vs. yesterdayPlausible API key and site, Fathom API key and site, or a Google Analytics 4 service-account key and property ID
Ad SpendToday's spend, clicks and cost per click, vs. this time yesterdayMeta access token and ad account ID, Reddit Ads credentials, or Google Ads (developer token, OAuth client and customer ID — the setup screen walks you through it)

Ad spend counts as money: it hides like revenue does.

Home and devices

Home Assistant and Device Batteries widgets in a dock
Home Assistant and Device Batteries.
WidgetShowsNeeds
Home AssistantThe lights, switches and sensors you pick; click to toggleYour Home Assistant address and a long-lived access token
Device BatteriesAirPods (left, right and case), Magic Mouse, Keyboard and Trackpad, lowest first—

Home Assistant usually runs on your home network, so macOS may ask once to let Moor find devices on your local network.

Calendar, media and weather

WidgetShowsNeeds
Next EventYour next meeting, with a Join button for video callsCalendar access (asked the first time)
RemindersReminders you can check offReminders access
Today's TasksTasks due today or overdue from Reminders, Todoist or Things 3; tick them off from the popoverReminders access, a Todoist API token, or Things (open; its URL auth token to tick off)
Now PlayingApple Music or Spotify, with controls and cover artPermission to control the player (asked once)
WeatherCurrent conditions and forecast, severe weather alerts (US, National Weather Service) and air qualityA city, or your location
SlackUnread DMs and @mentions, per conversationA Slack user token (scopes below)

Slack scopes. Create an app at api.slack.com/apps, add the User Token Scopes im:read, mpim:read, search:read and users:read (plus channels:read and groups:read so channel mentions show as read once you've read them), install it to your workspace and paste the User OAuth Token (xoxp-…) in Settings → Accounts. A bot token only sees DMs sent to the bot. Discord isn't supported: its terms forbid using personal tokens this way.

Keys and privacy

Keys go in Settings → Accounts, which has a search box and says which widgets use each key. They're stored in your Mac's Keychain, sent only to the service they belong to, and never synced or exported. Money widgets show •••• when Hide Revenue Figures is on (menu bar → Modes), while you share your screen in Zoom, or during calls.

This page as Markdown: /docs/widgets.md