Quick start
Install Susi and the model, then write, edit and send your first prompt. Most of the time goes to the model download.
What you need
- A Mac with Apple Silicon, running macOS 26 or later.
- Ollama , the Mac app or the
ollamacommand. Susi starts it when an edit needs it, and links to the download if it is missing. - Homebrew , for the recommended install.
1. Install Susi
brew install --cask octolab/tap/susiDownload instead
Download susi_0.1.1_darwin-arm64.zip from the v0.1.1 release, unzip it and move Susi to Applications.
This build is not notarized yet, so macOS stops the first launch and says it cannot verify Susi. Open System Settings → Privacy & Security, find the message about Susi near the bottom and click Open Anyway. macOS asks once; later launches open normally.
2. Download the model
ollama pull qwen3.5:4b-mlxSusi edits with this model only. It runs inside Ollama on your Mac, and Susi checks that it is local before it sends any text. More about the model →
3. Open the panel
Launch Susi. The panel appears, and the Susi icon appears in the menu bar. Susi has no Dock icon.
From now on, ⌘⇧Space shows the panel over any app and hides it again. The menu bar icon has Show Susi, Open Settings Folder and Quit.
If the line above the bottom bar says Could not register ⌘⇧Space, another app already uses the shortcut: see Troubleshooting.
4. Write a prompt
Type the task, or dictate it with a tool such as MacWhisper. For a first try:
Add a dark mode toggle to the settings screen.
Please make sure that it basically follows the system appearance by default and also remembers whatever the user picked last time.Susi keeps the draft as you type: hide the panel, quit, come back later, and the text is still there.
5. Rewrite part of it
- Select the second sentence with the mouse or with ⇧ and the arrow keys.
- Press ⌘K. The actions list opens above the bottom bar, with the field What to do with the selection?
- Type
short. Shorten is at the top; press Enter.
The selection dims while the model works, and Rewriting… replaces Action in the bottom bar; Esc cancels. The first edit can take longer while Ollama loads the model into memory.
The answer replaces the sentence as a diff: new words on green, removed words struck through. The line above the bar reads Shorten · ⌘← Back · ⌘→ Accept. Press ⌘← to see your original text, ⌘→ to come back to the diff, and ⌘→ again to accept it.
With nothing selected, an action takes the whole prompt. Editing and versions →
6. Send it
Press ⌘↵. Susi copies the whole prompt, hides, and returns you to the app you came from. Paste it into your coding agent with ⌘V.
The next time you open Susi, the prompt you sent is selected. Start typing or dictating for a new prompt, or press → or click in the text to keep working on it. ⇧⌘↵ copies the same way and leaves an empty prompt instead.
Next
- Actions and instructions: the six actions, your own wording, and adding actions of your own.
- Dictate with MacWhisper: run an action by saying its name.
- Library and files: templates, saved prompts and the settings folder.
- Keyboard reference: every key on one page.