FAQ

Does Togo cost anything?#

No. There is no account, paid tier or locked feature. The app is GPLv3 and the helper and relay are MIT licensed, so the source stays available to you.

Why GPLv3 for the app?#

Anyone who ships a modified app has to publish their changes under the same licence. The licence adds a permission to distribute through app stores such as the App Store, so the app can be published there while its source stays open. The helper and relay use MIT so you can run and adapt them freely.

Does it work without the helper?#

Yes. Any machine you can reach over SSH works as a terminal, with its own tmux sessions. The helper adds the native chat, sessions you start from the phone, the numbered list shared with your desk, "needs you" alerts and answers from the Lock Screen and Watch. See Install the helper.

Which agents work?#

Most of the agents Togo supports open in a native chat. Kiro CLI and OpenHands open in the terminal, as does any other program you run there. See Agents.

Claude Code, Codex, Auggie, Droid, Copilot CLI, Amp and Cursor CLI report requests through hooks. OpenCode and the other agents report through their own server or files. The screen watcher covers every agent. See Approvals.

Which platforms does it run on?#

The app runs on iPhone and iPad with iOS or iPadOS 26 or later, and on Apple Watch with watchOS 26 or later. The helper runs on macOS and Linux.

What does the relay see?#

Sealed notifications and answers it cannot open, your device tokens, your host id, IP addresses, and when each message is sent and how big it is. It can also read the plain status fields of a Live Activity update: the session number, the agent's name, its state, how many requests are waiting, when it started, the waiting request's id and, for an ended session, one word for why. It never sees a command, a request's text or terminal output.

What does the Live Activity show?#

The session, its agent and state, and the waiting request, with Approve and Deny when it can be answered in place. iOS draws it from a few plain fields. The session's title, its current step and the request travel sealed and are opened on your device. While a Live Activity runs, its update replaces the notification for the same event. See Approvals.

Are there rate limits?#

Yes, on the relay. A device token can get up to 30 pushes a minute, and a machine's mailbox accepts up to 120 answers a minute.

Do approvals work when my phone is offline?#

No. The request waits at the desk, and it expires on the phone after ten minutes. Sessions keep running either way.

Where do I report a bug?#

Open an issue in the repository. Report security problems privately, through the repository's Security tab. See Reporting a vulnerability.