Working with sessions from your phone

Once your phone is paired, the whole board travels with you. This page covers everyday session work from the phone: reading the roster, starting a session, chatting with an agent, watching its terminal, and opening the files it produces.

The home roster

The home screen is your session list, refreshed every few seconds. Sessions that are waiting on you float to the top under Needs you, longest-waiting first; everything else sits under Other sessions in the same order as your desktop board.

Each row tells you a lot at a glance:

• A colored status dot and a line describing what the session is doing right now - with a live waiting timer on anything that needs you.
• Small chips for the machine and repo the session runs in.
• A Snooze ended badge when a snooze expired on its own.
• A dictation badge while a spoken prompt is still uploading or transcribing, so a voice reply is never silently in limbo.
• On voice-mode sessions, a play triangle appears when a spoken update is ready - tap it to listen without leaving the roster.

If a machine drops off the network its sessions are kept and grayed, never removed - the row says it is reconnecting and when the machine was last seen. The same idea applies app-wide: on a bad connection the app keeps showing the last known information and says so in a banner, rather than blanking the screen.

Managing a session

Every session screen carries the same manage bar: back to the roster, Snooze (park a session so it stops asking for you; tap Unsnooze to wake it), and Remove. Remove asks for confirmation first - it terminates the session and cannot be undone.

Starting a session

1. Pick the machine

   Open New session from the roster or the menu. Every machine running a Director is listed with its uptime; the one you used most recently is pre-selected.

2. Pick the repository

   Tap one of the machine's recent repos, or type a full path under Or enter a path and tap Create session.

3. Talk to it

   The new session opens in Chat, ready for its first prompt. Session creation from the phone is deliberately simple - agent and model choices live in the desktop New Session dialog.

Chat

Chat is the default view of a session: the live conversation, cleaned up into speaker-labeled bubbles. A Show filter lets you also reveal Tool calls, Results, and Thinking - hidden by default, remembered on this phone.

The composer under every conversation has three verbs:

• Send - type a prompt and submit it.
• Speak - dictate instead. You talk, tap Pause to see the text (edit it if you like), then Insert it into the box or Send it straight to the agent. A spoken send keeps working in the background even if you leave the screen - the status strip and roster badge track it.
• Attach - open the camera or photo library and attach an image. The photo lands in the session and its path is inserted at your cursor, so you can add a sentence and send. This is how you show an agent a screenshot.
• Quick keys - Enter, Esc, Stop, and arrows - for answering an agent's menu prompts without opening the terminal.

Links in the conversation are live: URLs open in a new tab, and file paths open the built-in file viewer. Both carry a copy button.

Terminal

The Terminal tab is a live, read-only mirror of the session's real terminal, streaming as the agent works. Zoom with A- / A+, toggle Fit for full-width, and show the Keys row when you need to press Enter, Esc, or arrows. If the stream drops, the last screen stays visible while it reconnects.

Files

Tap any file path - in Chat or in the terminal - and the file opens in the app: images, PDFs, HTML, Markdown, and code all render in place, and anything without a preview offers a download. A Download button saves the file to your phone.