HelpSupport
How can we help?
Help with Yo for Mac (installing, the first open and updates), Windows and Linux, and the Yo app for iPhone (coming soon). Yo is free; if you'd like to chip in, see Support Yo. Still stuck? Contact us.
Yo for Mac
Install Yo
- Download Yo from the home page, open the .dmg from your Downloads, and drag Yo into Applications.
- Open it once. Yo isn't notarized by Apple, so macOS asks you to confirm it the first time. Open Yo and click Done. Then open System Settings → Privacy & Security, scroll down to "Yo was blocked", click Open Anyway, then Open Anyway again, and enter your Mac password.
- Connect your subscription. Pick Claude, ChatGPT or Grok, and Yo walks you through signing in. There's no API key and no Yo account.
- Let Yo set up its computer. The app brings the free tools it needs (Colima and Docker), so there's nothing extra to install. Then press Start my computer.
Prefer not to do it by hand? After you click Download on the home page, choose Copy a setup prompt and paste it into Claude Code or Codex. It does these steps for you and asks before it installs anything.
Questions about Yo for Mac
Which Macs can run Yo?
A Mac with Apple silicon (M1 or newer) and macOS 13 Ventura or newer. Yo needs at least 16 GB of memory (32 GB is better) and 10 GB of free disk space (20 GB is better). Intel Macs aren't supported yet. On a Windows or Linux PC, Yo runs in your browser instead (see how). See what Yo needs.
Can I use Yo on Windows or Linux?
Yes. On a Windows or Linux PC, Yo runs in Docker on your PC and you use it in Chrome, Edge or Firefox. It's the same Yo, without the Mac-only parts (Calendar, Contacts, Reminders, Notes, Mail and controlling Mac windows). Your PC needs Windows 11 or Windows 10 22H2 (64-bit), or a 64-bit Linux, with 8 GB of memory (16 GB is better), 4 processor cores recommended and 15 GB of free disk space.
On Windows, open PowerShell (Start menu, type PowerShell, press Enter) and paste:
irm https://github.com/JuniorSua/yo-app/releases/download/v2.0.866/install.ps1 | iex
On Linux, paste this in a terminal:
curl -fsSL https://github.com/JuniorSua/yo-app/releases/download/v2.0.866/install.sh | bash
It checks your PC, installs Docker if you say yes (Docker Desktop on Windows, Docker Engine on Linux),
and opens Yo in your browser, signed in. Run the same line again later to update or repair Yo; your
data stays. See the
full instructions.
I don't see "Open Anyway".
macOS only shows it after you try to open Yo. Open Yo from Applications, click Done, then look again in
System Settings → Privacy & Security, near the bottom. Or run this once in Terminal, then open Yo
as usual: xattr -dr com.apple.quarantine /Applications/Yo.app
Yo's computer won't start.
Yo checks your Mac and tells you what's missing, with the commands to fix it. Make sure you have about 20 GB free and that no other app is using most of your memory, then try Start my computer again. If it still won't start, use Settings → Bug reports → Report a problem in Yo: the report includes the logs we need, with passwords and personal details removed.
How do I update Yo?
Yo checks for new versions and tells you when one is out. Click Download, then install it the same way you did the first time. Your conversations, routines and settings stay. After an update, macOS may ask once about "Yo Safe Storage": enter your Mac password and click Always Allow.
Does Yo cost anything?
No. Yo is free and open source (Apache-2.0), with no paywall and no Yo account. It runs on the Claude, ChatGPT or Grok subscription you already have, so there's no other bill from us. If you'd like to help, see Support Yo. It's optional and unlocks nothing.
How do I uninstall Yo?
Quit Yo and drag it from Applications to the Trash. To remove its data too, see the privacy policy.
Asked for a licence key?
Some older versions of Yo asked for a licence key. Yo is free now and doesn't need one: download the newest version from the home page and install it the same way. Questions about a past payment? Email us.
Support Yo
Yo is free, and it stays free. If it's earned a spot in your day, you can chip in once or sponsor it monthly on GitHub. See Support Yo on the home page. It's a gift: it doesn't unlock anything, and everything stays the same either way.
Yo for iPhone
Coming soon. The iPhone app and Yo Phone are in testing and aren't available to everyone yet. The help below is for testers.
The Yo app is your Yo in your pocket. Send it a message, approve what it asks, stop a task, or talk to it hands-free in Drive mode. Yo does the work in a private workspace on your Mac or PC and texts you back.
What you need
- Your own Yo, set up on a Mac or on a home server that stays on. Get Yo here.
- A subscription you already have, like Claude or ChatGPT, which your Yo uses on your computer.
- An iPhone with iOS 17 or later.
No Yo yet? Tap Try the demo on the app's first screen to look around. The demo runs entirely on your iPhone with made-up replies.
Pair the app with your Yo
- On your computer, open Yo and go to Settings → Phone. Tap Create phone link. (Or ask Yo: "Set up Yo Phone on my phone." It asks for your OK first.)
- Get the link to your iPhone. Send it to yourself, for example in a note or a message to your own number.
- Open the Yo app and choose how to add it: Paste the link, Scan its QR code with the camera, or tap the link on your iPhone. If tapping opens Safari instead, copy the link and use Paste.
- That's it. Say hi. Under each message, Sent means it reached the relay, and Delivered means your Yo has it.
Keep your link to yourself. Anyone with it can text your Yo as you, including your chats, files and approvals. If it ever gets out, make a new link in Yo and the old one stops working.
Using the app
- Approve or Deny: when Yo needs a yes or no, a card shows up. Your answer goes straight to Yo.
- Open Yo on your computer: some requests, like changes to your Mac or taking over the screen, can only be answered on the computer itself.
- Stop: tap Stop to end what Yo is working on.
- Drive mode: tap Drive for a big microphone button. Say what you need; Yo reads its replies aloud.
Questions about the iPhone app
Yo shows as offline.
The app shows Yo as online when your Yo has checked in during the last few minutes. If it's offline, the computer Yo runs on is probably asleep, turned off, or not connected to the internet, or Yo isn't running. Open Yo on that computer (or wake it up) and wait a moment. Messages you send while it's offline wait for it in the relay for up to 30 days and are delivered when it's back. A home server that stays on keeps Yo reachable even while your laptop is closed.
It says "This link was turned off."
That link no longer works, because someone turned Yo Phone off or made a new link in Settings → Phone, or because your Yo hadn't checked in for about 30 days. Make a new link in Yo and add it to the app again.
It says "This link is from an older version."
Links made by older versions of Yo aren't supported. Update Yo on your computer, then make a new link.
Yo says it's busy.
To keep things safe, Yo works on a few phone messages at a time. Wait a minute and send it again.
How does Drive mode work?
Tap Drive, then the microphone, and say what you need. When you stop talking, the app sends it after a short pause (tap to cancel), and Yo reads its replies out loud. The first time, iOS asks for microphone and speech recognition access. The app uses on-device recognition when your iPhone supports it. Set things up before you drive, and keep your eyes on the road.
What is the demo?
Try the demo shows how the app works without a Yo. It runs entirely on your iPhone with made-up conversations, approvals and replies, and doesn't connect to anything. Leave the demo any time to pair with your own Yo.
Do I need a Mac?
Your Yo needs a computer to run on: a Mac, a Windows or Linux PC (Yo runs in your browser there, see Yo on Windows or Linux), or an always-on home server. See the requirements. The iPhone app only needs your phone link.
Does it cost anything?
The iPhone app is free, with no ads or in-app purchases. Your Yo runs on the subscription you already have.
Is my data private?
Messages are end-to-end encrypted between your iPhone and your Yo, and the relay in the middle can't read them. Your history stays on your phone. There are no accounts, analytics or ads. Read the privacy policy for the details.
How do I remove my data?
In the app, tap Forget this link to erase the link and your history from the phone. In Yo on your computer, Settings → Phone → Turn off deletes the relay mailbox and turns the link off.
Can I use one link on more than one phone, or share it?
A link is personal: whoever has it is treated as you. Don't share it with anyone else. A guest mode with its own limits may come later.
Contact
Email us at our support address, about anything: installing, updates or a past payment.
In Yo, open Settings → Bug reports → Report a problem. It reaches us directly, no account needed.
Or open an issue on GitHub. Please don't post your phone link or private messages there.