Getting started

Togo is an iPhone, iPad and Apple Watch app for coding agents that run in tmux on a machine you own. For most agents a session opens as a native chat, and the agent's terminal is one tap away. Start and answer sessions on your phone, and attach to the same sessions at your desk.

Togo's only server is an optional push relay. It hands notifications to Apple and carries answers from the Lock Screen and Watch. Your terminals stay between your phone and your machine. Your agents still send your prompts and code to their model providers, as they do at your desk.

What you need#

  • An iPhone or iPad on iOS 26 or later.
  • A Mac or Linux machine to run your agents, with tmux 3.2 or newer.
  • SSH access from your phone to that machine, for example on your home network or over Tailscale. On a Mac, turn on Remote Login in System Settings › General › Sharing.

Set up in four steps#

  1. Install the app. See Install the app.
  2. Install the helper on your machine. It is optional and adds the agent features: the chat, sessions you start from the phone, "needs you" alerts and answers from the Lock Screen and Watch. See Install the helper.
  3. Pair your phone with the machine. See Pair your phone.
  4. Start a session.

Without the helper, any machine you can reach over SSH still works as a terminal with its own tmux sessions.

Start a session#

On your phone, tap the plus button, then pick the machine, the folder and the agent. To start one at your desk, run:

$ togo new

List sessions and attach to one by its number:

$ togo ls
$ togo attach 01

A session started on either side shows on both.

Next#

Install the app. To learn how requests reach your phone and how to answer them, read Approvals.