Mobile App
Run your desktop coding agents from your phone with Nimbalyst Mobile. Start and resume sessions, review diffs, and edit markdown on the go.
Nimbalyst Mobile lets you run your AI coding agents from your phone. Start new sessions, resume existing ones, review diffs, edit markdown files (alpha-for now) — all from your phone. It's not just a viewer; it's a full remote workspace for your agents.
Why Mobile?
You're running multiple parallel sessions. You step away from your desk — lunch, commute, a meeting. Your agents finished 20 minutes ago and you have no idea. Or worse, one hit a blocker and has been sitting idle for an hour.
Nimbalyst Mobile keeps you connected to your agents wherever you are. Start new work, continue existing work, or just keep an eye on things.
See mobile agent management for what the phone app covers.
How It Works
Nimbalyst Mobile is available for iOS. It securely links to your local desktop running Nimbalyst. Select which projects you want to sync and start running sessions, editing files, and managing your agents on the go.
Setup
Authenticate to Nimbalyst
Select which projects you want synched
Download the Nimbalyst mobile app from the iOS App Store
Sign in with your email; Nimbalyst sends a magic link to finish signing in
Click on the Pair Device icon in the desktop app
In the mobile app, scan the QR code
Authenticate in the mobile app 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. Switch to the account that owns a project or received a team invitation when that content is not visible.
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 enabled projects sync to mobile. You can both read and edit them — update documentation, plans, and notes directly from your phone. Edits sync back to desktop immediately. [Alpha for now]
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 directly from your phone — pick a project, type a prompt, and the session runs on your desktop machine. You can start sessions while commuting, in a meeting, or wherever you get an idea.
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.
Open a project and stay on its Sessions list.
Tap the + button in the top right to open the new session menu.
Tap the Model row at the bottom of the menu. It shows the current agent and model selection.
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.
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. Color-coded status. Sorted by activity. One tap to see details.
Diff Review on Mobile
Swipe through file changes with visual red/green diffs optimized for mobile. Approve or reject individual changes. Leave comments for the agent.
Resume
Session stalled? Resume it with a voice note or typed instruction right from your phone. Redirect the agent. 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 — your draft is there waiting.
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 for setup, controls, and troubleshooting, or Voice Mode for the desktop side.
Push Notifications
Get notified when sessions complete, hit errors, or need your approval. No more checking. No more FOMO. Your agents tell you when they need you.
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.
Desktop Sync
Everything syncs with your desktop Nimbalyst workspace. Changes you approve on mobile appear instantly on desktop. Sessions you queue from your phone start running on your machine.
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 — only fetching 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 All Agents
Manage Claude Code and Codex sessions from one app. One interface for all your coding agents, wherever you are.
Last updated