Skip to content

iOS app

experimental The iOS app is still being worked out, and its screens and features may change or be removed.

The assist iOS app shows your sessions on your phone: see which agents are waiting on you, read their terminals, reply and answer their questions, away from your desk. It connects to one of your web servers over Tailscale and shows that node’s sessions along with those of every linked node.

The iOS app session list, with sessions that need you above running onesThe iOS app session list, with sessions that need you above running ones
The iOS app session list, with sessions that need you above running ones

The app is distributed through TestFlight. Install TestFlight on your iPhone, accept your tester invite, then install assist from TestFlight.

Once your App Store Connect app is configured, open TestFlight testers from the dashboard’s menu to see each tester’s invite and install status. Enter an email and press Add to add a tester to the external group. Turn on Internal to invite them to your App Store Connect team instead, then add them again once they accept to put them in the internal group.

The TestFlight testers dialog, listing internal and external testers with their statusThe TestFlight testers dialog, listing internal and external testers with their status
The TestFlight testers dialog, listing internal and external testers with their status

The node the app connects to is its home node. Before connecting, connect Tailscale on the phone and link the node over Tailscale so its web server is reachable on your tailnet.

Open Connect mobile from the dashboard’s menu on that node and scan its QR code with the iPhone camera. The app adds the node and makes it the home node.

The Connect mobile page, with the node's QR code and tailnet URLThe Connect mobile page, with the node's QR code and tailnet URL
The Connect mobile page, with the node's QR code and tailnet URL

To enter the address by hand instead, on first launch enter the address you open the dashboard at in a browser as the Web server URL, such as https://mac.tail1234.ts.net:3100, and press Connect. Name is filled in from the host name and labels the node chip at the top of the session list.

Connecting the iOS app to a home node on first launchConnecting the iOS app to a home node on first launch
Connecting the iOS app to a home node on first launch

Tap the node chip to list your saved nodes. Tap one to make it the home node, the pencil to edit or delete it, or Add node URL to save another. Deleting the home node makes another saved node the home node, or, if it was the last one, takes you back to connecting a home node. The app remembers your choice across launches.

The iOS app's saved nodes, with the home node selectedThe iOS app's saved nodes, with the home node selected
The iOS app's saved nodes, with the home node selected

When the home node can’t be reached, the app shows the error. Press Retry now, or pick another node under Switch home node.

The tab bar along the bottom switches between Sessions, Backlog and History.

Tap a repo in the chip row above the Sessions or History list to show only that repo’s entries, or All for every repo. A dot on a repo’s chip means one of its sessions needs you. The app remembers your choice across tabs and launches.

The iOS app session list filtered to one repo by its chipThe iOS app session list filtered to one repo by its chip
The iOS app session list filtered to one repo by its chip

On a History entry’s transcript, Resume starts it again as a live session and opens it. Tap the conversation id under the title to copy it.

The iOS app's Backlog tab, with the tab bar along the bottomThe iOS app's Backlog tab, with the tab bar along the bottom
The iOS app's Backlog tab, with the tab bar along the bottom

On a backlog item, pick the node and harness to run on, then tap Start to run it, or Refine to start refining it in a new session.

Tap ⋯ on a session’s screen, or long-press its row in the list, for its actions:

  • Mark done… marks a backlog item done and ends its session.
  • Auto-advance phases is the dashboard’s Continue toggle for a backlog run.
  • Transfer to node moves a backlog run to another node.
  • Start over session, beside Restart session, discards the conversation and starts a new one with only the session’s first prompt.
  • Tap the # number in the header to copy the session’s id, or the conversation id beneath it to copy the harness’s id for the conversation.
A backlog item's session actions in the iOS app, including Mark doneA backlog item's session actions in the iOS app, including Mark done
A backlog item's session actions in the iOS app, including Mark done

Sessions asking you a question or proposing a backlog item are listed under Answer here. Backlog runs in their review phase are listed under Review, with a count of those waiting on you; tap it to collapse them. A session waiting on a manual check shows the check on its screen: try it, add an optional note, and tap Works or Doesn’t work. During a backlog run, Later phase moves the check to a later phase of the item instead.

In a Claude session, typing a word starting with / in the reply bar lists your skills and commands that match it, followed by the repo’s own. Tap one to put it in your reply.

In a Claude (SDK) session, tap Claude’s suggested next prompt above the reply bar to put it in your reply.

When an agent puts something in the preview pane, such as a proposed backlog item or a pull request, a card on its screen shows what it is, with the same buttons as on the dashboard.

A proposed backlog item's card on a session's screen in the iOS appA proposed backlog item's card on a session's screen in the iOS app
A proposed backlog item's card on a session's screen in the iOS app

Tap Review full item, or Review on other previews, to read the whole of it. Select text there and tap Comment to comment on it as in the pane: Send to agent, Add to review, Cite a broken rule or Add rule. The comments you’ve added to the review are listed at the bottom of the sheet, where you can remove any before you approve or reject. With linked nodes, pick the node to run on above Approve & start.

The iOS app's review sheet showing a proposed backlog item in fullThe iOS app's review sheet showing a proposed backlog item in full
The iOS app's review sheet showing a proposed backlog item in full

Start a session on the home node hands-free, such as from CarPlay, by saying “Hey Siri,” then:

Say Starts
“Assist draft” or “Assist idea” A /draft session that writes a backlog item
“Assist bug” A /bug session that files a bug
“Assist prompt” A plain agent session with what you say as its first prompt

“Backlog” works in place of “Assist”. Siri asks which repo, then for your note, reads the note back and starts the session when you say yes.