What these pages hold is kept on this Mac only. Quicklinks, snippets and clipboard history are never sent to Sensei or your workspace. Call audio stays on the Mac too; see Record calls for the transcripts Sensei receives.
Spotlight
Sensei Spotlight is a panel that opens over any app. It finds your Mac's apps and files, your Sensei threads, tasks and Files, Settings pages and Mac commands. It also answers questions, calculates, and starts a Sensei thread. It uses your Sensei account: sign in once in the app and the panel works from anywhere. Signed out, it shows Sign in to Sensei and Open Sensei.
Open Spotlight with a keyboard shortcut
Until a shortcut opens it, Open Spotlight is the first item in the menu-bar menu. The shortcut is off until you turn it on, so a launcher such as Raycast or Alfred keeps ⌘Space. To use one:
- Open Settings > This Mac > Spotlight.
- Turn on Open Sensei Spotlight with a keyboard shortcut. It uses ⌘Space, and its badge reads Bound once it works.
- To use other keys, click the Shortcut row and press the new keys, for example ⌥Space. Press Cancel or Esc to keep the old ones, or Use ⌘Space to go back.
A shortcut needs ⌘, ⌥ or ⌃. ⌘ with a letter, number or punctuation key alone is refused, because app menus use those. Pressing the shortcut again hides the panel.
The macOS Spotlight shortcut row says whether macOS Spotlight uses ⌘Space, On or Off, and Open Keyboard Settings opens System Settings to change it. While macOS Spotlight uses ⌘Space and you chose ⌘Space, the badge reads Blocked and Free up ⌘Space for Sensei shows the steps: in System Settings > Keyboard > Keyboard Shortcuts > Spotlight, turn off Show Spotlight search, then press Re-check. If another launcher uses the same keys, both open: give one of them other keys.
Your choice is kept on this Mac only, through restarts and updates. Turn the switch off to give the keys back at once.
Open, move and close
The panel floats over every app, full-screen apps included, without bringing the Sensei window forward.
- Move it by dragging its header or an empty edge. It opens where you left it. Double-click the header to centre it again.
- Close it with Esc, by clicking outside it, or by switching to another app. When the search box has text, Esc clears it first.
- Reopen it within 5 minutes and your last search or answer is still there.
Before you type
The empty panel lists Needs you: Threads, your threads that need you in every workspace, newest first, each with how many cards wait. Under it, Recent lists what you open most often. Personal Files never show in Recent.
Search
Type to search. The list shows up to 9 results, best match first, and each row names what it is:
| Row | What it finds |
|---|---|
| App | Apps in Applications, in your own Applications folder and the system's apps. |
| File, Folder | Files and folders on this Mac, by name, from 2 characters. Without Full Disk Access, the folders macOS protects are skipped. Library folders, the Trash and build folders such as node_modules are always skipped. At most 3 files a search. |
| Thread | Your own Sensei threads, archived ones included. |
| Task, Repository, Cron | Tasks, projects and Crons in every workspace you belong to. Archived tasks are left out. |
| File, Folder in Files | Workspace and Personal Files, by name, from 2 characters. Personal ones carry a Personal label, and the footer says only you can see them. Enter opens them in Files. |
| Page | The Overview, Tasks, Files and Crons pages of each workspace and of Personal. |
| Settings | Settings pages, by the name the Settings list gives them. A workspace's admin-only pages show only to its admins. |
| System Settings | The panes of System Settings on this Mac. |
| Command | Mac commands. See Run a Mac command. |
| Quicklink, Snippet | Your quicklinks and snippets. |
| Clipboard history | Type "clip" to open your clipboard history. |
Press ↑ and ↓ to pick a row and Enter to open it. The footer names what Enter does: Open, Run, Paste, Open in Files, Ask or Copy value. When a source cannot be searched, a line under the results says so, such as "Personal Files not searched." or "Results from this Mac only."
Run a Mac command
Type a command's name and press Enter:
- Lock Screen, Sleep, Eject All Disks, Toggle Dark Mode and Toggle Hidden Files run at once.
- Restart, Shut Down, Log Out and Empty Trash ask first, such as "Restart this Mac?". Press Enter again to confirm, or Esc to cancel.
Some commands need the Automation permission. macOS asks for it the first time.
Quick answers
Type a question and an Ask row appears under the results. It is picked for you when the text starts with a question word, such as why, what or how, or when nothing else matches. Press Enter on it.
The answer card, Quick answer, gives a short answer of a few sentences. It searches the web with Google Search for current facts and lists its Sources below. It knows your local time, and your city if your iPhone shares its location. It also reads your own Memory file general.md, so it can answer questions such as your company address. It does not read your files. The answer is not saved: the card says "Web answer. It does not read your files. Not saved to Sensei Chat."
- Press Enter on a finished answer to Ask a follow-up, up to 500 characters. Press ↑ to edit your last question.
- Press ⌘Enter, or Continue in Thread, to carry the questions and answers into a new Sensei thread.
- Press Enter on a failed or stopped answer to ask again.
Calculator and conversions
Spotlight works out maths, dates, time zones, units and currencies as you type, with no Ask needed. Enter copies the result.
| Kind | Try |
|---|---|
| Maths | 2^10, sqrt(16), 15% of 240, 20% off 80, 36 is what % of 240 |
| Dates | days until christmas, days since 1 jan 2026, next friday, 3 weeks from today |
| Time zones | 5pm london in dubai, 5pm in tokyo, noon utc in india |
| Units | 10 km in mi, 5 kg in lb, 100 f in c, 1 gallon in liters |
| Currencies | 100 usd in aed, 1 btc in usd |
A currency result names the rate's date and source. When the rates cannot be reached, it uses the last rate it has, up to 14 days old, and says "Rates offline". A number or a date on its own is a search, not a calculation.
Suggestions
As you type 3 characters or more, Spotlight can suggest how the text goes on, in grey after the cursor. Press Tab to accept it. A suggestion can also fix a misspelt conversion, so 71 farenheit to celsius becomes 71 °F to °C.
Suggestions use a short summary of your general.md, such as where you live, your languages, currencies and time zones, never the file itself. Numbers, contact details, addresses, family and other private details are removed before and after the summary is written. See Memory.
Start a thread
Press Tab when no suggestion shows, or Shift+Tab, to switch to Thread. What you typed moves into the box "Give Sensei a task. It starts a new Thread". It is the same box as New thread: pick a model, attach up to 20 files with Attach files or by dropping or pasting them, and mention with @. Press Enter or Start Thread.
Spotlight shows Thread started and Open thread (⌘O), and empties the box for the next one. Closing Spotlight never stops Sensei. If the message did not reach Sensei, your words and files come back: press Enter to send again. With thread routing on, Spotlight can send the message into an existing thread instead; see Threads.
Dictate
Hold fn to dictate into the search box. It reads Listening while it hears you. A final full stop is dropped, so a spoken conversion still calculates. Dictation needs the Microphone permission. Hiding Spotlight always turns the microphone off. See Voice.
Quicklinks
A quicklink opens a site from Spotlight by its name.
- Open Settings > This Mac > Quicklinks and press New quicklink.
- Type a Name, what you type in Spotlight to find it, such as
GitHub pulls. - Type the URL. Without
http://orhttps://, Sensei addshttps://. Other kinds of address, such asmailto:, are refused. - Press Save.
In Spotlight, type part of the name, or the start of the site's address, and press Enter. The site opens in your default browser.
Under Your quicklinks, each row shows the name and the site. Click a row to edit it, then Save, Delete or Cancel.
Snippets
A snippet turns a short keyword into its text. Type the keyword in any app and it becomes the text, or find it in Spotlight and press Enter to paste it.
- Open Settings > This Mac > Snippets and press New snippet.
- Type a Keyword: one word with no spaces, that you would not type by accident, such as
;addr. Each keyword can belong to one snippet only. - Type the Text it becomes. It can be several lines.
- Press Save.
A snippet expands when you type its keyword as a whole word and then a space or a punctuation mark. Return and Tab end the word without expanding it. Snippets do not expand while you type in Spotlight. In Spotlight, a snippet is found by its keyword, with or without its leading ;, or by any word of its text.
| Setting | What it does |
|---|---|
| Expand snippets as you type | On by default. Off, keywords no longer expand as you type, and Spotlight still finds every snippet. |
| A snippet's switch | On by default. Off, that snippet no longer expands, and Spotlight no longer lists it. |
| Accessibility | Expanding as you type, and pasting from Spotlight, need Accessibility. It reads Allowed or Not allowed. |
Until Accessibility is on, Allow Sensei to type for you shows the steps: press Open Accessibility settings, turn on Sensei, then come back and press Re-check. Click a snippet's row to edit it, then Save, Delete or Cancel.
Clipboard
Clipboard history keeps what you copy, so Spotlight can paste it again.
Save clipboard history in Settings > This Mac > Clipboard is on by default, and its badge reads Capturing. Turn it off to pause it: it reads Paused, and nothing you copy is kept until you turn it on again. What you copied while it was paused is never added.
What is kept:
- The last 200 items.
- Up to 40 images among them.
- At most 250 MB, oldest go first.
- Never anything a password manager marks as concealed.
- Stays on this Mac, never sent to Sensei or your Workspace.
Text is kept as plain text, and a single copy larger than 1 MB is not kept. A very large image keeps only a small preview.
Paste from your history
- Open Spotlight, type "clip" and open Clipboard history.
- Type to search the text and the app it came from. Each item shows a preview, its size and the app it came from, with how long ago.
- Press Enter to paste the item into the app you opened Spotlight over. It moves to the top of the history.
Without Accessibility, Sensei copies the item instead and tells you to press ⌘V. Press Delete to delete one item, and Esc to go back to search. The Capturing or Paused badge at the top turns saving on or off.
Clear the history
Press Clear history, in Settings > This Mac > Clipboard or at the top of the clipboard history in Spotlight. The row says how many items there are and how much space they use. Sensei asks "Delete all 12 items from this Mac?": press Clear history to confirm. It cannot be undone, and saving keeps going unless you turn it off.
Record calls
The desktop app can record your calls on this Mac. It needs macOS 14.2 or later. On an older macOS, Settings > This Mac > Calls reads Calls need macOS 14.2 or later. Record calls is off until you turn it on.
- Open the menu-bar menu, then Calls > Record Calls. You can also turn on Record calls in Settings > This Mac > Calls.
- Allow the microphone and system audio when macOS asks. Without both, nothing records, the badge reads Needs permission, and the page says which one is missing.
- Join a call in Zoom, Google Meet in a browser, FaceTime or another app. Sensei notices the app on the microphone within about 5 seconds.
- Choose Record on the notification, or Record This Call in the menu-bar menu. With no answer in 60 seconds, Sensei skips the call. To skip the question, turn on Always Record Calls in the Calls menu or Always record calls in Settings.
While a call records, the Sensei icon in the menu bar shows its recording dot, and the Settings badge reads Recording. Choose Stop Recording to end it; that call is not recorded again. The recording ends on its own about 10 seconds after the app leaves the microphone. Pause Recording in the Calls menu ends the current recording at once and records nothing until you clear it; the badge reads Paused.
Each call is a folder with two audio files: system.m4a, what the other people say, and mic.m4a, your side. Sensei deletes a call shorter than 15 seconds, and a silent call shorter than 3 minutes. Delete a call by deleting its folder.
Transcripts and threads
On macOS 26 or later, the Mac transcribes each call after it is saved, with Apple's speech recognition, in the language spoken. A call whose language is unclear, or not supported, gets no transcript. Transcribe Again in the Calls menu tries the failed ones again.
While Record calls is on, the Mac sends each transcript to Sensei, and the call becomes its own thread. Only the transcript is sent: the audio never leaves the Mac. Offline, a transcript waits and is sent later. The Calls menu counts what was sent, what waits and what was refused, with the reason.
Each call's thread is named after the meeting. With Google Calendar connected, Sensei uses the event that overlaps the call by at least 5 minutes, adds the date to a repeating meeting, and removes booking-tool words. With no event, it writes a short title from the transcript. A thread you renamed keeps your name.
Calls settings
Settings > This Mac > Calls, also opened with Calls Settings… in the Calls menu:
| Setting | What it does |
|---|---|
| Record calls | Off by default. Records when an app is in a call. |
| Always record calls | Off by default: each call asks Record or Skip. On records each call as soon as it starts, without asking. |
| Permissions | Microphone, your side of the call, and System audio, the other side. Pressing a switch opens System Settings. |
| Keep recordings | Deletes calls older than 7, 30 or 90 days, or 1 year. Forever keeps every call until you delete its folder. The default is 30 days. |
| Never captured | Apps that never start a recording, such as a dictation app. Press Add app, type an app name or bundle id, or pick one under Running now, then press Add. Each row says whether it matches by name or by bundle id. |
| Recordings | How many calls there are and the space they use. Show in Finder opens the folder. |
Sensei's own dictation never starts a recording.
Limits
- Settings > This Mac and every tool on this page are in the macOS desktop app only.
- Spotlight shows up to 9 results at a time.
- A quick answer is not saved, and a follow-up is up to 500 characters.
- Clipboard history keeps 200 items, 40 images and 250 MB, and skips a copy larger than 1 MB.
- Record calls needs macOS 14.2 or later, and transcripts need macOS 26 or later.