> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nomo.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Watch Claude Code and Codex from your iPhone, and answer their permission prompts without going back to your Mac.

Your coding agent runs on your Mac. You don't have to sit in front of it.

Nomo Sessions puts your running Claude Code and Codex sessions on your iPhone —
on the Lock Screen and in the Dynamic Island. When the agent stops to ask
permission for something, your phone tells you, and you can answer it from
there.

Walk to the kitchen. The agent keeps working. It hits a command it needs
approval for, your phone buzzes, you tap **Allow**, and it keeps going. You
never went back to your desk.

<Frame caption="One session in two places: live at the top of the screen, and in the Sessions tab under the computer running it.">
  <div className="device-frame">
    <img src="https://mintcdn.com/nomo-ba73b2e6/E9qWCA0MYZuhukCS/images/session-overview.png?fit=max&auto=format&n=E9qWCA0MYZuhukCS&q=85&s=7132ff78226249ade4f16fe9eddfd96d" alt="A Claude Code session called Refactor the Sessions tab, shown as a Live Activity and as a row in Nomo's Sessions tab" width="1217" height="2622" data-path="images/session-overview.png" />
  </div>
</Frame>

The live card carries the model and what it's doing right now — **Fable ·
Editing** — plus the session title, the folder, and which computer it's on.
Below it, the Sessions tab lists everything running, split by agent.

<Note>
  Sessions is part of Nomo Pro. Status monitoring and usage widgets are free and
  work without any of the setup below.
</Note>

## What's supported

Sessions follows the agent running on your computer, not the account behind it,
so the list is shorter than [Status and Usage](/status-usage).

<div className="provider-row">
  <span><img src="https://mintcdn.com/nomo-ba73b2e6/MPK4SXS3xULAM_00/images/claude-code.svg?fit=max&auto=format&n=MPK4SXS3xULAM_00&q=85&s=8fda5e5cc7b39669577504edfaecfeed" alt="" width="1200" height="799" data-path="images/claude-code.svg" />Claude Code</span>
  <span><img src="https://mintcdn.com/nomo-ba73b2e6/MPK4SXS3xULAM_00/images/codex.svg?fit=max&auto=format&n=MPK4SXS3xULAM_00&q=85&s=68f540059c9a6b314ba97f7a9ea43c62" alt="" width="1024" height="1024" data-path="images/codex.svg" />Codex</span>
</div>

## What you need

* Claude Code, or Codex 0.142+, on a Mac
* Either **bun** or **node 18+** — whichever you already have
* Your phone and your computer paired — one QR scan

## How it fits together

Your Mac sends session updates to your phone through Nomo's relay. The relay
can't read them: everything is encrypted on your Mac and only decrypted on your
phone. Nomo's servers move sealed data around without ever holding the key.

That matters for what you can expect — your prompts, file paths, and commands
are yours. It also means pairing is a real cryptographic step rather than a
login, which is why it takes a scan or a typed code.

## Get setup

<CardGroup cols={2}>
  <Card title="Install the plugin" href="/setup/install" icon="puzzle-piece">
    Two commands, for Claude Code or Codex.
  </Card>

  <Card title="Pair your computer" href="/setup/pairing" icon="qrcode-read">
    Scan a QR code, or type a one-time code.
  </Card>
</CardGroup>