Documentation

Using the app

The app has three tabs: Attention for what needs you, Projects for everything on the computer, and Connections for your paired computers. It follows your phone’s light or dark appearance and text size. Screenshots here use the app’s built-in preview projects.

Attention

Attention gathers the agents that need input, the ones that finished, and the panes you opened recently, across all your projects. The row of counters at the top filters by state: needs input, working, done, idle and plain terminals. Tap a row to open that pane.

Attention with one agent needing input and one finished
Needs input and finished
Attention with a Recent section below finished agents
Recently opened panes

Projects

Projects lists every workspace, its tabs and panes, with each agent’s state. Collapse the workspaces you aren’t following. With control access you can also create a New workspace or New tab, Split right or Split below, Start an agent from the agents installed on the computer, and Close pane (which ends the program in it).

Projects grouped by workspace and tab with agent states
Workspaces, tabs and panes
A pane's activity view showing recent output
A pane’s activity

Each pane has three views, switched from the menu under its title: Activity (recent output or the agent conversation), Terminal (the live screen) and Changes (Git).

The live terminal

The Terminal view streams the pane’s real screen as it changes. If your device has control access, opening it takes control and fits the terminal to your phone: the computer’s pane is resized to the phone’s width so nothing scrolls sideways, and its size is restored when you leave. Turn off Fit terminals to this screen to watch at the computer’s size instead, zooming with a pinch.

  • Text size. While you control a fitted pane, the floating A− and A+ buttons, or a pinch, set the terminal text size from 7 to 24 points. Smaller text gives you more columns and rows.
  • Scrollback. Drag to scroll the pane’s own history; Latest or typing returns to the bottom.
  • Programs that restart. When an agent exits and starts again in the same pane, the app follows the pane to its new program and never sends it input meant for the old one.
  • Pane actions. The ⋯ menu has Interrupt (Ctrl C), End input (Ctrl D), Suspend (Ctrl Z), Clear screen (Ctrl L), Release control and Take over.

Message box or terminal keyboard

Type with chooses how you type. The Message box (default) is a normal text field at the bottom: write or dictate a whole prompt, edit it with the usual iOS tools, and send it in one go. The text is pasted into the pane and followed by Enter, the way agents expect a prompt. Terminal keyboard sends each keystroke straight to the terminal, for shells, editors and menus.

Special keys

A compact key dock sits above the keyboard (hide it with Show special keys). Swipe it sideways for three pages; the page name flashes as you switch.

  • Keys
    Shift, Ctrl, Alt, Esc, Tab, Enter, the arrows and Ctrl C
  • Scroll
    Page Up, Page Down, Home, End, Ctrl Home, Ctrl End, Shift Page Up/Down, Backspace, Delete, Ctrl L
  • Ctrl
    Ctrl D, Z, R, O, T, B, A, E, U, W and K
Keys page: Shift, Ctrl, Alt, Esc, Tab, Enter, arrows, Ctrl C and the message box
Keys
Scroll page: Page Up, Page Down, Home, End and more
Scroll
Ctrl page with common control keys
Ctrl

Voice notes

Tap the microphone in the message box, or Voice note in the prompt draft, and speak. A timer and level meter show it is recording; the bin discards it. Stop, and the recording is transcribed on your phone and added to your draft, unsent, for you to review and edit. Choose the Speech language next to the button. The recording is deleted once it is transcribed.

Recording a voice note with a timer and level meter
Recording
Prompt draft with the transcribed text added
Transcribed into the draft

Transcription never falls back to a cloud service: if your phone or language has no on-device speech support, pick another language or type. Nothing is sent until you press send with control of the pane.

History and search

Tap the history button on a terminal to read back. For agents whose session the bridge can find (Claude Code, Codex, Pi and Qwen Code), history is the agent’s own conversation: your prompts, its replies and folded tool calls (the wrench shows or hides tool detail). Earlier messages at the top pages back to the start of the session. For other programs it is the terminal’s output: up to 1,000 lines with Herdr, and 500, 1,000 or 2,000 lines with plain terminals and Orca.

  • Find (the magnifier, or Command-F on a keyboard) searches the loaded history.
  • Select and copy any text; whole lines stay intact when they wrap.
  • A− and A+ (or a pinch) change the history text size.
  • Live returns to the terminal.
Conversation history with Earlier messages at the top
Conversation with earlier messages
Conversation history with tool calls expanded
Tool calls shown

Files and Git changes

Changes shows the project’s branch, how far it is ahead of or behind its upstream, and each changed file with lines added and removed. Tap a file for its diff, or browse the project’s files. Large or binary files may not preview, and ignored or sensitive paths can be hidden.

Changes with branch, ahead/behind and two changed files
Changed files
A unified diff of one file
A file’s diff

Connections and leaving the app

Connections lists your paired computers. Switch between them, or swipe one and choose Forget to remove it from this phone (revoke it on the computer too; see Pairing).

Switching to another app for a moment keeps everything connected for about 20 seconds. After that the app releases control and closes its connections; when you come back it reconnects and opens where you were. It also reconnects by itself when the network changes, keeping the last screen meanwhile. iOS does not keep connections open in the background indefinitely, so live viewing happens with the app open.

Want to try the interface first? Explore preview on the Attention tab opens clearly labelled sample projects without any computer. The Atlas API project in these screenshots comes from that preview.

WhatsApp