Guide
Set up Wren, step by step
About fifteen minutes from download to your first reminder, email alert and ChatGPT question. Each step says what to do and what you should see.
1. Download and open Wren
- On the download page, sign in with Google and download the DMG. You can watch the one-minute demo first.
- Open the DMG and drag Wren into Applications.
- Open Wren. macOS says “Wren” Not Opened, because this preview isn't notarized by Apple yet. Click Done (not Move to Bin).
- Open System Settings › Privacy & Security, scroll to the message about Wren and click Open Anyway. macOS asks once per version.
You should see: Wren's window, and a small bird in the menu bar at the top of the screen. Closing the window keeps Wren running there.
2. Allow notifications
- Open Settings (⌘ ,) and find Notifications.
- Click Send test notification. The first time, macOS asks to allow Wren's notifications: allow them.
- Within 10 seconds a notification appears, and Settings says Delivered.
Delivered but no banner? Do Not Disturb or a Focus is on. macOS still delivers Wren's notifications but puts them straight into Notification Center without a banner or sound. Turn Do Not Disturb off, or add Wren in System Settings › Focus. Also check that Wren's alert style isn't None in System Settings › Notifications › Wren.
3. Your first reminder, typed
- In any app, press ⌥ ⇧ Space. Wren's capture panel opens.
- Type
remind me to stretch in 2 minutesand press Return. - Wren answers Reminder created, with the time. Two minutes later the notification arrives, even if you quit Wren.
- In the notification, choose Done, or Remind me in 1 hour.
4. Talk to Wren
- Press and hold ⌥ Space. The first time, macOS asks for Microphone and Speech Recognition: allow both, then hold the keys again.
- While holding, say
remind me to call Sam tomorrow at 10 AM, then let go. - Wren transcribes on your Mac, shows the sentence, and runs it: Reminder created: Call Sam.
Wren only listens while you hold the keys (or after you click Voice). Nothing listens in the background. If speech isn't available, turn on Dictation once in System Settings › Keyboard.
5. Tasks and deadlines
I need to finish the report by Fridaymakes a task with a deadline. You get a heads-up the day before, at your default reminder time (10:00), and a reminder on the day.remind me to call Sam tomorrow at 10 AMis a reminder at that time, not a deadline.mark the report as done,move that reminder to Sunday: Wren shows what it will change and Return confirms.- Change the default reminder time and the day-before heads-up in Settings › Notifications.
6. Morning briefing and evening check-in
At 11:00 Wren sends a short briefing: what's overdue, due today and tomorrow, and anything important. At 19:00 it asks what you finished. Change both times in Settings › Daily rhythm, which also shows what happened to today's. Wren has to be running for these (step 10).
7. Connect Gmail and Calendar
- Open Connectors (⌘ 7) › Gmail › Connect Google.
- Sign in on Google's page and tick Gmail (read-only) and Calendar if you want them.
- Back in Wren, Gmail shows Connected with your address. Wren then checks your inbox once and sends an Inbox review: the unread mail from the last 14 days that looks like it needs you.
- While Wren runs, it checks every 5 minutes. Important new mail, such as a failed payment, a payment deadline, a security alert or a direct question, gets one notification. Click it to open that email in Gmail.
“Access blocked” from Google? While Wren's Google sign-in is in testing, only accounts on its test list can connect. Ask the developer to add your Gmail address. Google also asks testers to reconnect every 7 days.
Email is sorted on your Mac with rules. Its content is never sent to ChatGPT or any other AI service.
8. Ask ChatGPT
There are two ways, chosen in Connectors › ChatGPT under “Ask GPT …” goes to:
- Ask in ChatGPT (website), the default. Works with any ChatGPT account, including free, and needs no connection. Say or type
ask ChatGPT what gradient descent is: chatgpt.com opens in your browser with your question, ready to send. - Run with ChatGPT inside Wren. Needs a ChatGPT Plus or Pro plan. Click Continue with ChatGPT, sign in on OpenAI's page in your browser, and approve Wren, including use of your ChatGPT plan. The answer then appears in Wren.
Several Chrome profiles (school, work, personal)? Each profile has its own ChatGPT sign-in, and a link opens in whichever profile was last in front. In Connectors › ChatGPT › Open ChatGPT in, choose your personal profile: asking ChatGPT, opening a linked conversation and Continue with ChatGPT then always use that account. Works with Chrome, Brave, Edge, Chromium and Vivaldi.
Can't connect?
- OpenAI asks you to upgrade: that ChatGPT account has no Plus or Pro plan. You don't need to upgrade: use the website mode above, which works with any account.
- “can't share its plan with apps”: the account has no Plus or Pro plan (or it's a workspace that doesn't allow it). Use the website mode instead.
- “plan usage not authorized”: you didn't approve plan usage on OpenAI's page. Click Allow plan usage….
- The button just comes back: read the Last attempt line under it, which gives OpenAI's reason. Make sure the browser that opens is the one where you're signed in to ChatGPT, and finish the sign-in within 5 minutes.
9. Local AI (optional)
Questions that don't name ChatGPT, such as what is a vector database?, can be answered on your Mac. Install Ollama, then open Local AI (⌘ 8) and click Set up and test. Without it, Wren asks who should answer.
10. Keep Wren running
Reminders arrive even after you quit Wren, because macOS holds them. The briefing, check-in and email alerts need Wren running. Turn on Settings › Open Wren when I log in and keep it in the menu bar. ⌘ Q quits completely.
If something doesn't work
- No notifications: Settings › Notifications shows the permission, how many reminders macOS holds, and where it's failing. See step 2.
- The shortcut does nothing: another app may use the same keys. Wren says so in Settings, and you can pick another combination.
- Gmail says “temporarily unavailable”: Wren keeps retrying by itself. Inbox › Check inbox now tries at once.
- All shortcuts and things you can say are on the Shortcuts page.