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).
Adding a widget
- Press ⌃⌥E to edit your docks.
- Choose Add in the toolbar, or search for the widget in the Add to your docks panel.
- 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.
| Widget | Click does |
|---|---|
| Now Playing | Plays or pauses |
| Stopwatch, Focus Timer | Starts or stops |
| Shortcut | Runs the shortcut |
| AirDrop | Opens AirDrop |
| Audio Output | Switches 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

| Widget | Shows |
|---|---|
| Clock | Time and date, digital or analog |
| World Clock | Times in other cities, with day and night |
| Focus Timer | Work and break phases (can turn on Zone mode while you work) |
| Countdown | Time left until a date — a launch, a trip, a deadline |
| Stopwatch | A stopwatch |
| Time Progress | How much of the day, week, month and year has gone |
System

| Widget | Shows |
|---|---|
| Battery | Charge, whether it's charging, and the time left, or the time until it's full |
| CPU & Memory | Live CPU and memory use |
| Memory | Memory used, memory pressure, and the apps using the most memory (more) |
| Audio Output | The sound output and its volume. Click to switch to the next output. Open the details to pick one, set the volume or mute |
| Network | Download and upload speed |
| Disk | Free space |
| Shortcuts | A grid of your Shortcuts, one click to run |
| Shortcut | One shortcut's text output ("3 unread", "72°"), run on click or every 1, 5, 15 or 60 minutes |
| AirDrop | Drop files on it to share them |
| Custom | A 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:
- the breakdown: App Memory, Wired, Compressed, Cached Files and Swap Used
- the memory pressure graph
- Top apps by memory: the 8 apps using the most memory. Helper processes are counted under their app, as in Activity Monitor.
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:
- Clean runs macOS's own
purgecommand once, which empties the cache of recently used files.purgeneeds an administrator, so macOS asks for your password every time. Moor doesn't store it, and nothing keeps running as an administrator afterwards. If you cancel the prompt, nothing happens. - Super clean needs no password. For a moment it fills memory in the background, which makes macOS drop cached files to make room, and then it lets that memory go. It only starts while memory pressure is normal, and it stops at once if pressure rises, so other apps aren't pushed into swap; macOS may still compress some of their memory for a moment. It never takes more than half your Mac's memory. Afterwards, it lists big apps you haven't used for a while (30 minutes and 500 MB by default), playing no sound and not in front. For each one, you choose Keep, Quit or Relaunch, and nothing happens until you confirm. Apps quit the way they do with ⌘Q, so they can ask you to save. Moor never force-quits, and never lists Moor, Finder or the apps you've told it to leave alone.
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.
| Setting | Default | What it does |
|---|---|---|
| Clean automatically | Off | Turns on the rules below |
| Ask for my password so automatic cleaning can use Clean | Off | Automatic 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 below | Off, 1 GB | Free 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 reaches | Off | High or Critical. Needs Clean, because Super clean only runs while pressure is normal |
| Every N hours | Off, 4 | 1 to 24 hours |
| Wait at least … between cleans | 30 minutes | 15 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 Mac | All on | Calls 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 clean | On | Says what was freed and which rule ran |
| Super clean's app list | 30 minutes, 500 MB | How 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.
| Setting | config key | Values |
|---|---|---|
| Menu bar shows | bar | "used" (default), "percent", "pressure" |
| Refresh every | refreshSeconds | 2, 3 (default) or 5 |
| Notify me when memory pressure is critical | notifyOnCritical | false (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

| Widget | Shows | Needs |
|---|---|---|
| Shopify | Today's sales and orders, vs. yesterday, 7-day chart | Admin API token (read orders) |
| Stripe | Today's volume, payments, balance | Restricted key (read Balance, Charges, Customers) |
| RevenueCat | MRR, active subscriptions, trials | Secret API key |
| App Store | App Store Connect sales | App Store Connect API key |
| Lemon Squeezy | Today's orders and sales, vs. yesterday, 7-day chart | API key |
| Paddle | Today's completed transactions, vs. yesterday, 7-day chart | API key (Paddle Billing) |
| Gumroad | Today's sales, vs. yesterday, 7-day chart | Access token |
| Google Play | Crash 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 Summary | Every revenue source together | — |
| Crypto Prices | Coin prices | — |
More in Revenue.
Coding agents

| Widget | Shows |
|---|---|
| Agents | Your Claude Code, Codex, Cursor, Windsurf, Gemini CLI, Aider, OpenCode and Trae sessions by project: working, needs you, or gone quiet |
| Project | The project your agents are in, one click from its editor, a terminal, Finder or GitHub |
| Agent Dock | Every Claude Code and Codex session with its state, last line and a click to open the chat. See Coding agents |
| Claude Code Usage | Your Claude Code tokens and cost |
| Dock Pulse | One dot for CI, deploys, Sentry, Slack and sales: all clear, attention or alert (below) |
| GitHub | Open 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.
| Dot | Means |
|---|---|
| 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

| Widget | Shows | Needs |
|---|---|---|
| CI Status | The latest run per repo or workflow, green, red or running; a badge when the newest run on the main branch fails | GitHub token (Actions), App Store Connect API key (Xcode Cloud), or a CircleCI token |
| Vercel Deploys | The latest deployment per project, its state and age | Vercel token (team ID optional) |
| Deploys | The same for Cloudflare Pages and Workers, Netlify, Railway and Fly.io | That service's API token (Cloudflare also needs your account ID) |
| Sentry | Unresolved issues first seen in the last 24 hours, with a badge for new ones | Sentry auth token and organization |
| Linear | Your open assigned issues, in progress first | Linear personal API key |
| Jira | Your open assigned issues, by priority | Site address, email and API token |
| GitHub Issues | Open issues assigned to you | GitHub token |
| Docker | Running containers; start, stop and restart from the popover | Docker Desktop (or another Docker engine) running |
Click any row to open it in the browser.
Analytics and ads

| Widget | Shows | Needs |
|---|---|---|
| Web Analytics | Visitors right now, and today vs. yesterday | Plausible API key and site, Fathom API key and site, or a Google Analytics 4 service-account key and property ID |
| Ad Spend | Today's spend, clicks and cost per click, vs. this time yesterday | Meta 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

| Widget | Shows | Needs |
|---|---|---|
| Home Assistant | The lights, switches and sensors you pick; click to toggle | Your Home Assistant address and a long-lived access token |
| Device Batteries | AirPods (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
| Widget | Shows | Needs |
|---|---|---|
| Next Event | Your next meeting, with a Join button for video calls | Calendar access (asked the first time) |
| Reminders | Reminders you can check off | Reminders access |
| Today's Tasks | Tasks due today or overdue from Reminders, Todoist or Things 3; tick them off from the popover | Reminders access, a Todoist API token, or Things (open; its URL auth token to tick off) |
| Now Playing | Apple Music or Spotify, with controls and cover art | Permission to control the player (asked once) |
| Weather | Current conditions and forecast, severe weather alerts (US, National Weather Service) and air quality | A city, or your location |
| Slack | Unread DMs and @mentions, per conversation | A 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