> For the complete documentation index, see [llms.txt](https://docs.nimbalyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbalyst.com/mobile/mobile-app.md).

# Mobile App

Run your desktop coding agents from your phone with Nimbalyst Mobile. Start and resume sessions, answer approvals, and edit synced markdown on the go.

Nimbalyst Mobile is an iOS app that runs your desktop coding agents from your phone. Use it when you are away from your desk and want to start new sessions, resume or redirect running ones, answer an agent that is waiting for approval, and edit synced markdown files (in alpha for now).

### Why Mobile?

When you run multiple parallel sessions, agents often finish or hit a blocker while you are at lunch, commuting, or in a meeting. Nimbalyst Mobile keeps you connected so you can start new work, answer a waiting agent, or just keep an eye on things from wherever you are.

See [mobile agent management](https://nimbalyst.com/mobile-agent-management/) for what the phone app covers.

### How It Works

The mobile app links securely to the desktop app running Nimbalyst. You select which projects to sync, then run sessions, edit files, and manage your agents from the phone while the work itself executes on your desktop machine.

iPhone and iPad share one adaptive layout. Rotating the device preserves the active session and any draft you are composing, and wide screens add a session sidebar so you can switch sessions without leaving the one you are reading.

### Setup

1. On desktop, sign in to Nimbalyst and select which projects you want synced.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2FxU9xZLC0iO1g9jlV6nS6%2Fimage.png?alt=media&amp;token=37ab0da4-c59d-4787-becb-4671c18a1f31" alt="The desktop sync settings panel with the signed-in account, the Projects to Sync list, and the Pair Device button"><figcaption><p>On desktop: the signed-in account, the Projects to Sync list, and the Pair Device button.</p></figcaption></figure>

2. Download the Nimbalyst mobile app from the **iOS App Store**.
3. Sign in with Google or use your email address and the magic link Nimbalyst sends you.
4. On desktop, click the **Pair Device** icon.
5. In the mobile app, scan the QR code and authenticate with the same credentials.

**If QR scanning doesn't work** (camera issues, bright sunlight): use the "Copy to Clipboard" option on desktop and paste the pairing data manually into the mobile app's text field.

### Use Multiple Accounts

You can sign in with more than one Nimbalyst account on iOS and switch between them from the account menu.

Each account keeps its own organizations, project access, paired-device state, and personal sync profile. If some content is not visible, switch to the account that owns the project or received the team invitation.

On desktop, manage accounts under **Settings > Account > Accounts** and choose mobile projects under **Settings > Account > Mobile App**.

***

### What Syncs to Mobile

**Sessions:** Full conversation history, session metadata (title, provider, model), status, and draft inputs you're composing.

**Project Files:** Markdown files (`.md`) from projects with **Docs** enabled sync to mobile. You can read and edit them, so documentation, plans, and notes stay updatable from your phone, and edits sync back to desktop. Document sync is currently available on the Alpha update channel: select **Alpha (Developer Releases)** under **Settings > Application > Advanced**, then enable **Docs** for the project under **Settings > Account > Mobile App**.

**What doesn't sync:** Code files, images, Excalidraw diagrams, mockups, data models, PDFs, CSVs, app settings, and extension data. These remain on desktop only.

***

### Start New Sessions

You don't need to be at your desk to kick off work. Start a brand new AI session from your phone: pick a project, type a prompt, and the session runs on your desktop machine.

### Choosing a Model

Pick which agent and model run your work right from your phone. The model you select becomes the default for new sessions you start on mobile.

1. Open a project and stay on its **Sessions** list.
2. Tap the **+** button in the top right to open the new session menu.
3. Tap the **Model** row at the bottom of the menu. It shows the current agent and model selection.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-f563c4aa20f97e33fd93592788750ec471483345%2Fmobile-model-menu.png?alt=media" alt="Mobile new session menu showing the Model row at the bottom"><figcaption><p>The new session menu, with the Model row showing the current agent and model.</p></figcaption></figure>

4. In the **Select Model** sheet, tap the model you want. A checkmark marks the active choice.

Models are grouped under **Agents**:

* **Claude Agent (Claude Code)**
* **OpenAI Codex**

The list reflects the providers and models you have set up on your desktop, so what you see may differ.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-adc0b74306c8f06815a2696c8d2daf9ebe57bc81%2Fmobile-select-model.png?alt=media" alt="Select Model sheet listing Claude Agent and OpenAI Codex models with the active one checked"><figcaption><p>The Select Model sheet, with Claude Agent and Codex models grouped under Agents and the active model checked.</p></figcaption></figure>

Each session in your list also shows its own model badge, so you can tell at a glance which agent is running each one.

### Session Dashboard

See all your active, completed, and paused sessions at a glance, with color-coded status, sorted by activity. One tap opens the details.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-7fc63cb88e5781fa2620988f6659c03cb0a8fa7d%2Fmobile-session-dashboard.png?alt=media" alt="Mobile session list filtered by All, Active, Planning, and Done"><figcaption><p>The session list with All, Active, Planning, and Done filters; each session shows its model and phase.</p></figcaption></figure>

### Answer Questions and Approvals

When a session is waiting for input, open it to answer the question or respond to its approval request. This includes tool permissions, plan approval, and commit proposals surfaced in the transcript. Code diff review remains a desktop workflow.

### Resume

Session stalled? Resume it with a voice note or typed instruction right from your phone. Redirect the agent or continue the conversation just like you would on desktop.

* **Queue a prompt:** If the session is busy, your prompt queues and runs when the current task finishes. You can queue multiple prompts while offline.
* **Attach images:** Take a photo or choose from your camera roll. Useful for screenshots of bugs, whiteboard sketches, or design references.
* **Draft sync:** Start typing a message on mobile, switch to desktop, and your draft is there waiting.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-b2447624f79d08322a14e4999fc637138acc625d%2Fmobile-resume-reassign.png?alt=media" alt="Mobile session view with the agent&#x27;s result above and the composer below"><figcaption><p>The composer below a finished response, ready to send a follow-up instruction.</p></figcaption></figure>

### Voice on Mobile

Drive your desktop sessions by voice from your phone. Ask the voice agent to start a new session, find a session by topic, switch between sessions, summarize one (including any question it is waiting on), answer a pending question, or send a new coding task to your desktop.

There is no permanent mic button. Start voice from the **•••** menu inside a session (**Start Voice Mode**), or from the **+** menu on a project's **Sessions** tab (**Start Voice Agent**). The floating mic appears once it connects, with **Pause** and **Cancel** so you stay in control.

Voice runs in the iOS app and is in alpha. See [Voice on Mobile](/mobile/voice-on-mobile.md) for setup, controls, and troubleshooting, or [Voice Mode](/setup-nimbalyst/voice-mode.md) for the desktop side.

### Lock Screen Live Activity

On iPhone, your session fleet also reaches the Lock Screen and Dynamic Island as a Live Activity. Sessions are ranked by how long each one has been waiting on you, so the agent that has been blocked the longest is the first thing you see. Tap a session to open it in the app.

### Push Notifications

Get notified when sessions complete, hit errors, or need your approval. Your agents tell you when they need you, so you can stop checking.

**Smart routing:** Notifications only go to your phone when you're away from your desktop. If Nimbalyst is active on your Mac, your phone stays silent.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-87523ae87fb02524e740db8eda190c3ee3eedcfb%2Fmobile-push-notifications.png?alt=media" alt="A Session Complete push notification from Nimbalyst"><figcaption><p>A Session Complete notification summarizing what the agent finished.</p></figcaption></figure>

### Desktop Sync

Sessions, prompts, supported approvals, and enabled markdown documents sync with your desktop Nimbalyst workspace. Prompts you queue from your phone run on your desktop machine, and markdown edits sync back to the corresponding project file.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-e31f97ee2106b33f9d89f8deccc6bdb158c1b93c%2Fmobile-desktop-sync.png?alt=media" alt="Mobile Settings screen showing the sync connection status as Connected"><figcaption><p>The mobile Settings screen showing the sync connection status.</p></figcaption></figure>

### Sleep Prevention / Keep Awake

A common issue with mobile sync is your desktop going to sleep, which breaks the connection. In Nimbalyst Settings, you can enable **sleep prevention** to keep your desktop awake while syncing. Choose between:

* **Off**: default, no sleep prevention
* **Always**: keeps your desktop awake whenever Nimbalyst is running
* **When plugged in**: only prevents sleep when your computer is connected to power

### Clickable Links in Transcripts

Links in session transcripts on iOS are tappable, so you can open URLs directly from your mobile session view.

### Encryption and Privacy

All data synced between your devices is end-to-end encrypted:

* **Encryption:** AES-256-GCM per message, each with its own initialization vector
* **Key exchange:** Via QR code during setup; keys never touch our servers
* **Server access:** Our sync servers store and relay encrypted data. They cannot read your content.

Your encryption key is derived from the seed shared during QR pairing using PBKDF2 with 100,000 iterations.

### Offline Behavior

* **Reading:** Previously synced sessions and files are cached locally and readable without connectivity
* **Writing:** Compose and queue prompts while offline; they transmit automatically when you're back online
* **Limitations:** No push notifications or real-time updates while offline. New desktop sessions won't appear until you reconnect.

When you come back online, the app syncs incrementally, fetching only messages newer than what you already have.

### Troubleshooting

**Sessions not appearing on mobile**

* Verify the project is enabled under **Settings > Account > Mobile App** on desktop.
* Confirm that the same account is active on the desktop and phone.
* Check that mobile sync is enabled for that account.
* Ensure both devices are online.

**Push notifications not working**

* Check that notifications are enabled in your phone's system settings for Nimbalyst.
* Notifications are suppressed when Nimbalyst is active on desktop. This is intentional.

**Sync feels slow**

* Large sessions with many messages take longer on first sync.
* After initial sync, updates are incremental and near-instant.
* Check your network connection on both devices.

### Works With Claude Agent and Codex

Manage Claude Agent and OpenAI Codex sessions from one app. Other direct chat providers can also appear in the mobile model picker when they are enabled on desktop.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2Fgit-blob-e5e2c433eb08f54521454bd1d002af6a74a552da%2Fmobile-all-agents.png?alt=media" alt="The Select Model sheet showing OpenAI Codex models with the active one checked"><figcaption><p>Codex models in the Select Model sheet, with the active model checked.</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nimbalyst.com/mobile/mobile-app.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.