Guide · Start
Getting started
Three permissions, one key, and one shortcut to undo.
Allow three permissions
Click Puckie's icon in the menu bar. Anything missing has a Grant button that opens the right place in System Settings.
| Permission | Why Puckie needs it |
|---|---|
| Accessibility | To read what's under your pointer and press buttons for you. |
| Microphone | To hear you, only while you hold the key. Never in the background. |
| Speech Recognition | To turn what you say into text. This happens on your Mac. |
Settings → Permissions lists every permission Puck can use, what each one is for, and says when one is on that Puck no longer needs, so you can turn it off.
Hold the key and talk
Hold 🌐 (the globe key, bottom left), say what you want, and let go. Puckie shows what it heard and what it did at the top of the screen, and sits beside your pointer while it works.
Point and speak
Put your pointer on something and say “click this”, “what is this?” or “type hello here”. Puckie acts on what you're pointing at.
Undo
⌥⌘Z undoes the last thing Puckie did, and that turn then ends on “Undid it”, in Recent and on your iPhone. Before doing anything that can't be undone, like sending a message, Puckie asks you to tap to go ahead.
Get more done
Say “close Slack” or “quit Brave Browser” to close an app. If it has unsaved work, the app asks you first, as it always does.
A routine is a few steps in one sentence. “run focus” closes your chat apps, and “run start my day” opens Calendar, Mail and Slack. To add your own, put them in ~/Library/Application Support/Puck/recipes.json. If a routine would do something that can't be undone, Puckie asks you to tap once before starting it.
Start with “on the web” to have Puckie do something online in her own browser window, which isn't signed in to anything: “on the web, find the Wikipedia article about Ada Lovelace”. Start with an app's name to do it there: “in Notes, make a new note called groceries”. “on this Mac, …” uses the app in front, and asks you first.
Make Puckie yours
In Settings, choose Puckie to pick her coat: Charcoal, Midnight, Ginger or Snow. Whatever the coat, the light around her still shows what she's doing. Your iPhone shows the same coat. To hide her from beside your pointer, switch off Show Puckie by the pointer, here or in the menu bar panel. Her face also appears at the top of the screen while Puck works: ears forward while she listens, a slow blink when something worked. To keep just the words there, switch off Show Puckie in the notch.