Gestures on the iPhone and iPad¶

This page lists the gestures in the iPhone and iPad app: swipes on rows, long presses, pulls, the chat's ··· menu, the edge pull for panes and the folder terminal. The Mac window does most of these with a right-click or a two-finger swipe, and the web page with a row's ··· menu.

A long press on a row opens the same menu that a right-click opens on the Mac, less what the phone leaves to the Mac, such as Show in Finder and Folder Settings.

Session rows¶

These work on a session's row in the sidebar, and on its card on the folder's page.

The session's menu has these, when they apply:

• Stop, and Stop All for a session that started others that still run.
• Carry on, for a session that is blocked.
• Open in New Window, on an iPad.
• Mark as Read or Mark as Unread, for a session that is done.
• Rename…, Pin or Unpin, and Move Up and Move Down for a pinned session.
• Branch and Archive.
• Keep Session, for a session that asks to be archived. The session stays.
• Unarchive and Delete…, for an archived session.

Other rows¶

A tap on a folder's heading, or on its Workflows row, folds or unfolds it.

Pull down to refresh¶

Pull down on these lists to ask the control plane again: the sidebar (archived folders too), a workflow's page, Runtimes, the cost and token pages, worktrees, events, connectors, reports, People and the machine providers. The app also catches up by itself when it connects and each time you go back to it, so a pull is for when you think it has missed something.

In a chat¶

The chat's ··· menu¶

On an iPhone, the chat's bar has only one button, ··· (#1020). A phone's bar has no room for more, so everything else is in it, in this order:

• Carry on, first, while the session is blocked.
• Find in Chat, Prompts and Open File….
• The panes: Page once there is one, Files, Terminal and Simulator, then Exchanged. They are left out when the Mac is too old to give them, except Exchanged.
• Rename… and Branch.
• Pin or Unpin, and Archive.
• Unarchive, in place of the last three, on an archived session.

On an iPad, the bar has room. Carry on, Pin or Unpin, Archive or Unarchive, and Panes are buttons of their own. The ··· menu keeps Find in Chat, Prompts, Open File…, Exchanged, Open in New Window, Rename… and Branch.

Panes¶

On an iPad with room for it, a pane opens as a column on the right of the chat, as on the Mac. Drag the line between the chat and the column to make the column wider or narrower. On an iPhone, or an iPad without room, the pane opens over the chat, and Back closes it. The switch at the top of a pane goes to the others: Page, Files, Changes, Terminal, Exchanged and Simulator.

The folder terminal¶

Folder Terminal opens the folder's own shells, in the folder on its host (#418). They are the shells that Control-` opens on the Mac. They are not an agent's, so they stay in the folder whichever session you open.

• Open it from Folder Terminal in the bar of any page of the folder.
• On an iPad with a keyboard, press Control-`.
• Each shell is a tab. Closing a tab ends its shell. End Shell ends the shell in front.
• Done, or Control-` again, puts the shells away and leaves them running.

Away from home, through the relay, the folder terminal and the panes say they need the same network, because a shell sends too much for iCloud.

Keys above the keyboard¶

A shell has a row of keys that a touch keyboard does not have: ^C, esc, tab, ctrl, the four arrows, |, ~, / and -. ^C interrupts what runs with one tap. It is a key of its own because it is the key you need in a hurry, and ctrl then c is two taps.

With a keyboard on an iPad¶

See also¶

• Keyboard shortcuts
• Use a shell in an agent's folder
• Stop and archive agents
• How the phone and iPad reach your agents