Support

Last updated: October 28, 2026

Contact

For help with tatu or the app, write to support@tatu.codes. Tatu is built and supported by one person, so replies may take a few days. For questions about your data, write to privacy@tatu.codes.

To help us find the problem, tell us your operating system, the tatu version (tatu --version), for a problem with the app its version and your device, and what you did before it went wrong. Do not send credentials, API keys or the contents of your sessions.

Before you write

Troubleshooting covers the most common problems and shows where tatu writes its log (~/.tatu/logs/tatu.log).
Frequently asked questions
The documentation, from installing to scripting.

The app

The app is on the App Store for iPhone and iPad and in beta on Android: get the app. These answers help with the usual questions.

The app cannot pair with my computer

On the computer, run /remote setup once and then /remote pair inside tatu. The QR code is valid for 60 seconds; if it expired, the panel shows a new one.
Confirm an invitation only if you just requested it on your computer.
/remote status tells you whether the session is connected, and why not. See Set up and pair.

My computer does not appear, or a session is out of date

The agent runs on your computer, not on the phone or tablet, so the computer needs to be on and tatu running. If the connection drops, the session keeps running, and the app syncs again when it reconnects.

I do not get notifications

Check that notifications are allowed for the app in your device's settings. On macOS, tatu holds back notifications for two minutes after you use the keyboard or mouse. Start tatu with TATU_REMOTE_PUSH_ALWAYS=1 to send them anyway.

I lost a phone or want to remove a device

Run /remote devices to see the paired devices and /remote revoke <id> to remove one and cut off its access.

I want to start over

Revoke the device on the computer and pair again with /remote pair. Do not delete ~/.tatu/remote/identity.json: it is the identity of the computer, and losing it means pairing every device again.