# Sesh on iPhone and iPad

> Every session on every machine, in your pocket, with approvals right on the lock screen.

Source: https://sesh.codes/docs/iphone-and-ipad/

Sesh on iPhone and iPad does everything the Mac does with a session: chat, approvals, Changes, terminals and dev servers. It doesn't run agents itself. It connects to your Mac and your other machines, so nothing that matters lives on the phone.

## Your machines come along

Sign in with the same Apple ID as your Mac and there's nothing to set up: your Mac and the machines you added on it show up on their own, through iCloud. On a different Apple ID, see [Pair an iPhone or iPad](https://sesh.codes/docs/add-a-machine.md#pair-an-iphone-or-ipad).

Your theme, notification choices and New Session defaults follow you over iCloud too.

## Answer from anywhere

![A session's chat on iPhone](https://sesh.codes/screenshots/iphone-chat.webp)

- **From the Lock Screen.** Approval notifications have **Allow** and **Don't Allow**. Allow asks you to unlock first. While sessions work, a Live Activity shows them on the Lock Screen and in the Dynamic Island.
- **From the list.** Sessions waiting on you sit in **Needs You** at the top. The app icon's badge counts them.
- **While it works.** Type your next message any time. It waits and goes out when the agent finishes.

Notifications arrive even when Sesh is closed. See [Notifications](https://sesh.codes/docs/notifications.md), which also covers [Live Activity](https://sesh.codes/docs/notifications.md#live-activity-and-dynamic-island), widgets and [Apple Watch](https://sesh.codes/docs/notifications.md#on-apple-watch).

> **Away from home?** Your Mac stays awake while an agent works, but sleeps between tasks like any Mac. To start new work from anywhere, [keep it from sleeping](https://sesh.codes/docs/add-a-machine.md#reach-your-mac-while-youre-away).

## Find your way around

- **On iPhone**, the session list comes first. Tap a session to open it.
- **On iPad**, the sidebar and the session sit side by side, like on the Mac.
- **Swipe** a session to archive it, or the other way to pin it. Long-press for the full menu.
- A session's toolbar has **Changes**, **Terminal**, the globe for dev servers, and **⋯** for everything else.
- **Settings** is the gear in the sidebar.
- **Routines** sit below the sessions. Open one to see its runs or change it; make new ones on the Mac. See [Routines](https://sesh.codes/docs/routines.md).

## Start a session

1. Tap **New Session**, the square-and-pencil button.
2. Pick the project, then type the task.
3. Open **Options** to choose the machine, the agent, **New branch** and **Autonomous**.
4. Tap **Start**.

Type `@` in the task to mention a file in the project.

## Terminals

The session's terminal opens as a sheet on iPhone. Pull it halfway and the chat stays usable above it. On iPad it opens as a split under the chat.

Keys for Esc, Tab, Ctrl and the arrows sit above the keyboard. See [Terminals](https://sesh.codes/docs/terminals.md).

## With a keyboard

On iPad with a hardware keyboard, the Mac's menus and shortcuts work: New Session, the Terminal menu, the command palette and moving between sessions. Return sends a message and <kbd>⇧↩</kbd> adds a line. See [Keyboard shortcuts](https://sesh.codes/docs/keyboard-shortcuts.md).

## Attachments and dictation

- Paste an image into the message box, or tap the paperclip for **Photo Library** or **Files**.
- Dictation runs on the device. Nothing you say leaves it.

## Dev servers

The globe opens a session's dev server inside Sesh. A server on another machine is forwarded to the phone, and only answers while Sesh is in front, which is why it opens in Sesh rather than Safari. **Open in Browser** is still in the page's toolbar. See [Dev servers](https://sesh.codes/docs/dev-servers.md).

## Good to know

- **Open In** an editor is Mac only.
- On iPhone and iPad, agents from the ACP Registry show their initial instead of their icon.
