# Mac tools

The Sensei desktop app for macOS adds tools that work across your Mac: Sensei Spotlight, quicklinks, snippets, clipboard history and call recording. You set each one up in Settings > This Mac, which shows only in the desktop app. To install the app and give it its permissions, see [Mac app](https://kosuke.ai/docs/devices/mac.md).

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](https://kosuke.ai/docs/devices/mac-tools.md#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:

1. Open Settings > This Mac > Spotlight.
2. Turn on **Open Sensei Spotlight with a keyboard shortcut**. It uses ⌘Space, and its badge reads **Bound** once it works.
3. 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](https://kosuke.ai/docs/devices/mac.md#permissions), 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](https://kosuke.ai/docs/workspace/files.md), 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](https://kosuke.ai/docs/devices/mac-tools.md#run-a-mac-command). |
| Quicklink, Snippet | Your [quicklinks](https://kosuke.ai/docs/devices/mac-tools.md#quicklinks) and [snippets](https://kosuke.ai/docs/devices/mac-tools.md#snippets). |
| Clipboard history | Type "clip" to open your [clipboard history](https://kosuke.ai/docs/devices/mac-tools.md#clipboard). |

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](https://kosuke.ai/docs/your-day/memory.md) 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](https://kosuke.ai/docs/your-day/memory.md).

### 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](https://kosuke.ai/docs/sensei/threads.md).

### 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](https://kosuke.ai/docs/sensei/voice.md).

## Quicklinks

A quicklink opens a site from Spotlight by its name.

1. Open Settings > This Mac > Quicklinks and press **New quicklink**.
2. Type a **Name**, what you type in Spotlight to find it, such as `GitHub pulls`.
3. Type the **URL**. Without `http://` or `https://`, Sensei adds `https://`. Other kinds of address, such as `mailto:`, are refused.
4. 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.

1. Open Settings > This Mac > Snippets and press **New snippet**.
2. 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.
3. Type the **Text** it becomes. It can be several lines.
4. 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

1. Open Spotlight, type "clip" and open **Clipboard history**.
2. 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.
3. 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.

1. Open the menu-bar menu, then **Calls** > **Record Calls**. You can also turn on **Record calls** in Settings > This Mac > Calls.
2. 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.
3. 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.
4. 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.

## Next steps

- [Mac app](https://kosuke.ai/docs/devices/mac.md) to install the app and give it its permissions.
- [Memory](https://kosuke.ai/docs/your-day/memory.md) for what Spotlight's answers and suggestions read.
- [Voice](https://kosuke.ai/docs/sensei/voice.md) to dictate to Sensei.
