Support
Most problems come down to two things: the two Macs are on different versions, or the network will not carry the connection. Work through the checks below before writing in.
Try the FAQ first; write to us if it does not help. Please include the app version (Settings → About) and your macOS version, plus reproduction steps or a screenshot if you have them.
Four checks first
- Make sure both sides are on the latest version. Fixes such as automatic file resending only work when both ends have them.
- In System Settings → Privacy & Security → Local Network, confirm Hai is enabled. Without it, the app cannot find peers on your LAN.
- Connect with an invitation code rather than copying an IP and port by hand; the code carries the public key, so you know who you are talking to.
- Open Settings → Network & Connection and look at the link state: direct, relayed, or not connected at all.
Getting started
Do I need an account?
No. There is no account system and no phone number or email sign-up. On first launch the app generates an Ed25519 key pair on this Mac as your identity; the private key stays in the app data directory and is never sent anywhere.
Your identity does not follow you to another Mac automatically — migrate the data directory if you need that (see “Data and backups”).
How do I connect to someone?
Create an invitation code under Network & Connection and send it to the other person (any channel works). They paste it and the direct connection is made. The code contains your address and public key, never your private key, so forwarding it does not expose your identity.
On the same LAN, the app also discovers devices via Bonjour, so in most offices you will not need to exchange codes at all.
Which systems and languages are supported?
macOS 14.0 or later; Intel and Apple silicon (universal binary).
The interface ships in nine languages: Chinese, English, 日本語, Deutsch, Français, Español, Русский, العربية and עברית (the last two right-to-left).
Connection problems
The other side always shows “offline”
“Offline” means no usable connection right now — not that you were removed. Work through these:
- Is the app actually running on their Mac? Closing the window is not the same as quitting.
- Do both machines have Local Network permission?
- On the same subnet, does discovery work? Across networks, do you have IPv6 or a relay configured?
- Corporate and hotel networks often block device-to-device traffic entirely; a relay is the only option there.
On the same Wi-Fi but we cannot find each other
First check that you are on the same subnet — sharing a Wi-Fi name is not enough. Router “AP isolation” and guest networks block device-to-device traffic, and corporate networks often block the multicast that Bonjour needs.
In those cases, an invitation code or a relay gets you connected faster than further network debugging.
Works at home, not at the office
Across networks you need one of two paths: IPv6 direct, or a relay. Automatic port mapping over IPv4 depends on the router and does not work everywhere — the app is sandboxed, which restricts UPnP-style mapping. So “home yes, office no” is expected behaviour, not a regression.
For regular cross-network work, configure a relay under Network & Connection. It forwards ciphertext only and cannot read your content.
File transfer
A file never arrived; the app says “file not on this Mac”
That message means the message arrived but the bytes did not — usually because the sender was offline when sending, or the transfer was interrupted.
Current versions hold the file on the sender’s side and resend it automatically once the other side is online. Files sent before that version was installed are not retroactively resent; ask the sender to send it once more.
It says “file pending” on my side
The file is queued on your Mac, waiting for the other side. It is resent as soon as a connection is established and the label disappears.
Queued records are kept for seven days; after that, or if the attachment copy is cleaned up, resending stops. Do not delete the app data directory while something is pending.
The recipient got the same file twice
That should not happen: the receiving side ignores a retransmission when it already has a complete copy. If you do see duplicates, send us both versions and the timestamps — that is a defect, not intended behaviour.
Data and backups
Where is my data, and how do I back it up?
Everything lives in the app’s sandbox container, in one folder:
~/Library/Containers/com.workbuddy.bizcollab/Data/Library/Application Support/Hai
Copy that folder and you have a complete backup — database, attachments and identity key. To restore, put it back at the same path.
Does uninstalling delete my data?
No. Dragging the app to the Trash removes the program only; the container stays. To remove everything, delete that folder as well — deletion is permanent and we hold no copy to restore from.
Moving to a new Mac
Copy the container folder to the same path on the new machine, then open the app. Your identity key travels with it, so peers still see the same you and no codes need to be re-exchanged.
If you upgraded from a pre-sandbox build, the old data sits in ~/Library/Application Support/Hai. The sandboxed app cannot see it — nothing is lost, the sandbox simply narrowed what the app can reach.
AI summaries and the demo
AI summary does nothing, or errors out
Summaries do not ship with a built-in model. You supply a model service address, model name and key. Without one, everything else in the app works normally.
Results are never written into your records automatically — you confirm each entry. That is deliberate: model guesses should not become facts.
I only have one Mac — can I still try it?
Yes. Settings includes an on-device demo that creates a local peer so you can walk through sending a message and a file. The demo conversation never goes over the network.
On recent versions you can also open a separate instance from the menu bar (Hai → New separate instance, ⌘⇧N) and treat it as the second endpoint: each instance has its own identity and data, and they can discover each other and exchange real messages.
That is still not the same as two physical Macs — cross-network behaviour, firewalls and routers only show up on real hardware.
When you write in
- App versionSettings → About, e.g.
1.0.0.14.5.22. - System versionApple menu → About This Mac, e.g. macOS 14.6.
- What happenedWhich step went wrong, and what the screen said. A screenshot beats a paragraph.
- What you triedRestarted, re-sent the code, switched networks — so we do not ask you to repeat it.
For questions about data handling, start with the privacy policy: it states what stays on your Mac, when data leaves it, and what a relay can see.