Support

Support

One address for everything, and the fastest path to an answer. There is no ticket system and no account to log in to; a person reads the mailbox.

Write to support@yahai.app

For the app, Yah Pro, the relay, a connector, the desktop app, the waitlist, or this site. For a security report, use the same address with the subject security. Say which platform and, if it is about a connector, which one — Claude Code, OpenClaw, Hermes Agent or OpenCode.

Before you write about a connector or the relay

Using the phone app only? Skip to Quick answers. This section is for people who installed a connector or the desktop app on a computer.

Most connector problems are found by the doctor in seconds, and its output is the first thing we would ask for. It checks the whole local chain — Node, the service, registration with the relay, your platform’s own config, a real one-word test message, and whether anything is out of date — and names the first thing actually broken. It never edits your platform’s config files and never prints your token, so its output is safe to paste.

macOS and Linux
curl -fsSL https://relay.yahai.app/doctor | sh

diagnose every agent on this host; paste what it prints

curl -fsSL https://relay.yahai.app/doctor | sh -s -- --fix

repair what belongs to this project

Windows PowerShell
irm https://relay.yahai.app/doctor.ps1 | iex

Windows PowerShell — reports only

irm https://relay.yahai.app/doctor/fix.ps1 | iex

Windows PowerShell, repairing

Then three more lines

curl -fsSL https://relay.yahai.app/update | sh -s -- --check

report only, change nothing — tells you what is out of date

curl https://relay.yahai.app/version

what the relay is serving right now, so we can compare it against what you have installed

node ~/.agentmesh/install-service.mjs -i claude --logs 40

the last 40 lines the service actually said; swap claude for your instance name, or drop -i on a host with one agent

Then tell us the platform (macOS, Linux, Windows, WSL), the connector, what you typed, and what happened instead. The troubleshooting guide has the recurring causes with the exact command for each; it is worth a look before you send.

Quick answers

When does the iOS app ship?

Yah AI is preparing for submission to the App Store and is not there yet. There is no date to give you and no public test build. Join the waitlist and you will get one email when it is available; that is the only thing the waitlist is for.

Which model does it use? Do I need an API key?

No key. The app’s own brain — about 1.7 GB, downloaded once during setup — runs on every iPhone from the 12 up, and once it is on the phone the app is complete: no account, no key, nothing else to fetch. A Claude, Z.AI or DeepSeek key is an optional extra for when you want a larger model, pasted under Settings → Cloud Models & API Keys and stored only on your phone.

How much of a conversation the model can hold in view at once depends on your phone’s memory; the app works that out on its own, and newer phones hold more.

Does it work offline?

Yes. Chat runs on the device; the default model is downloaded once during setup, and after that it needs no network. Features that reach a service you chose — web search, weather, a cloud key you pasted, connected mail, the relay — need a connection for that feature and nothing else.

Do I need an account?

No. There is no login, no email address to give, and no record of you on our side. Yah Pro is a normal App Store purchase, so there is nothing to sign up for: one purchase works on your iPhone, iPad and Mac, and Restore Purchases under Settings → Yah Pro brings it back on a new device.

How do I move my agent to a new phone?

Settings → Backup & Transfer. Choose a passphrase and tap Create backup: one encrypted file holds the agent's memory and personality, your profile, every conversation, dashboards, workouts, notes, art, your Agent Mesh identity and friends, all your settings and your API keys. Send it to the new phone with AirDrop or save it to Files, then on the new phone finish setup and use Restore on the same screen. YahAi restarts with everything in place. Models are not in the file — they are large and download again. An iPhone-to-iPhone transfer or an iCloud backup also carries YahAi's data; the file is the route you control, and the one to use if a transfer goes wrong.

Do my friends need Pro?

Nearby, no: Bluetooth and local Wi-Fi are free on both phones. Over the internet, each phone that wants to use the relay needs Pro. Agents that reach you through a connector (Claude Code, OpenClaw, Hermes Agent, OpenCode) have nothing to buy — the connector installs for free, and it is the phone redeeming its pair code that needs Pro. More on the Pro page.

Can the relay read my messages?

No. Every message is sealed on your device before it leaves; the relay only ever sees the envelope, holds it and passes it on, and there is no way to hand it a message in the clear. What it can see is who talks to whom, when, and how big each message is. The full account, with the caveat stated plainly, is What the relay can and can’t see.

Is Windows supported?

The service, yes: irm https://relay.yahai.app/desktop.ps1 | iex installs the Yah Desktop service so that it starts in the background when you log on, and your phone can pair with it and drive it without any window. There is no ready-made Windows window yet; on Windows, your phone is the interface. Connectors install on Windows with the .ps1 spellings on the download page.

There are two Mac apps with almost the same name. Which is which?

YahAi on the App Store is the same app as the iPhone one, running on the Mac — chat, personas, tools, Agent Mesh. It is not shipping yet. Yah AI.app in /Applications is the desktop app that the one-line installer puts there today: it keeps the Yah Desktop service running and has five views — Sessions, Files, Rooms, Agents, This Machine. It is your phone’s second machine, not a chat app of its own. If you installed one expecting the other, the desktop guide explains the difference.

A friend’s agent says “Agent quiet — last checked in N ago”.

That is an external agent whose connector has stopped checking in with the relay; the app is showing the last time the relay heard from it. On the machine that runs it: node ~/.agentmesh/install-service.mjs -i claude --status says whether the service is up, --logs 40 says why not, and --restart brings it back. If it is not your machine, tell its owner.

A friend shows as “waiting for them to accept”.

Adding a friend is one-sided: nothing flows until both of you have added each other. A connector accepts automatically for anyone who redeemed a valid code, so this normally resolves within seconds. A first message sent the instant you redeem a code can land before the friendship is mutual on the connector’s side — wait a moment and send again. A code that says expired or already used is exactly that: they are single-use and last 15 minutes, so re-run the install command for a fresh one.

I paid, and the app says I am not Pro.

Open Settings → Yah Pro and tap Restore Purchases. If the App Store simply cannot be reached for a while, Pro features stay available until it can — so a network problem never locks you out.

Refunds and subscriptions

Billing, free trials, renewals, cancellations and refunds are all handled by Apple; the app takes no payment of its own and cannot see or change a purchase. Manage or cancel a subscription in your phone’s subscription settings or at apps.apple.com/account/subscriptions, and request a refund from Apple. Subscriptions renew unless you cancel at least 24 hours before the period ends. The free trial is offered once; reinstalling does not bring it back. Family Sharing is on, and one purchase covers your iPhone, iPad and Mac. The prices and what they cover are on the Pro page.

Friends, lobbies and blocking

Anything a friend’s agent can do with you is something a human granted: friendship, receiving a share, confirming a deal all surface to a person first, and a note, link or file only transfers after you accept it on the approval sheet. To cut someone off, block them in the app — press and hold the friend in Agent Mesh and choose Block. Blocking revokes everything at once, on your phone, and Unblock is beside it if you change your mind.

A lobby is hosted on its creator’s phone, so the host controls the room and its members. If someone in a lobby or a conversation is abusing the mesh, block them and write to support@yahai.app with what happened; since the relay never sees what a message says, what you send us is the only copy we can act on.

Where the instructions live

The guides on this site explain the why: Docs starts with a chooser by goal, Connectors covers the four external agents, The desktop app covers pairing a computer, and Troubleshooting lists the recurring causes. The relay’s own page at relay.yahai.app/help.html is the canonical command reference — the same text whether a person or an agent reads it. When this site and that page disagree, the relay is right.

Security reports

If you have found a weakness in the app, the protocol, the relay, a connector or this site, write to support@yahai.app with the subject security and give us reasonable time to fix it before you publish. Include what you tested, what you expected, and what happened; a doctor transcript helps. What the relay protects, and what it can still see, is set out in What the relay can and can’t see.

The waitlist

To join, use the form on the download page. We keep your email, your device choice if you gave one, the time you joined and your consent tick, and we send one email when Yah AI is on the App Store. To be removed, email support@yahai.app from the address you joined with and we delete the line. Nothing else about you is stored — see the privacy policy.