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

# Mobile App Overview

> Use the Pioneer mobile app to connect to gateways, manage workspaces, and continue threads from iOS or Android.

The Pioneer mobile app connects to existing gateways from iOS or Android. Use it to continue threads, check task output, switch workspaces, or steer a gateway away from the desktop app.

The mobile app does not run the assistant by itself. The gateway owns workspaces, threads, model calls, tools, MCP servers, skills, tasks, artifacts, settings, and durable storage.

## What it can do

The current mobile client includes:

| Area             | Mobile behavior                                                                                                                   |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Gateways         | Add, validate, activate, update, and remove remote gateway entries.                                                               |
| Tokens           | Store gateway access tokens in the platform secure store.                                                                         |
| Workspaces       | Bootstrap, switch, create, and rename workspaces on the connected gateway.                                                        |
| Threads          | Load the thread tree, open thread timelines, send messages, stop turns, and keep an active thread projection.                     |
| Models           | List workspace API providers and supported CLI-backed model sources in one selector.                                              |
| CLI-backed turns | Show pending approvals or input requests for supported CLI-backed turns.                                                          |
| Composer         | Attach files, attach skills and MCP capabilities, choose a permission mode, send text turns, and use supported voice input flows. |
| AGENTS.md        | Read, save, and archive thread-tree instruction files.                                                                            |
| Preferences      | Configure mobile UI preferences such as theme and language.                                                                       |

## Saved gateways and tokens

Mobile keeps a local list of saved gateways and stores gateway tokens separately in the platform secure store.

That means the visible gateway entry can be edited or removed without showing the raw token back in the UI. If a token is rotated on the gateway, update the saved mobile connection with the new token.

## Remote gateway first

The mobile app currently manages remote gateway entries. It does not install, start, or supervise a local gateway process on the phone.

For mobile use, run a gateway on a computer, workstation, server, or other reachable host. Then add it in the mobile app with its address and bearer token.

<Note>
  Tool calls, local paths, MCP servers, provider requests, and task execution happen on the gateway, not on the phone. Permission modes and sandbox/resource policy are enforced by that gateway.
</Note>

## Consistency with desktop

Desktop and mobile use the same product concepts. A gateway, workspace, thread, provider, skill, MCP server, task, and artifact mean the same thing in both clients.

The difference is responsibility: desktop can install, start, and manage a local gateway, while mobile connects to gateways that already exist.

## Builds and locales

The mobile app targets iOS and Android and uses the same eight UI locales as desktop: English, German, Spanish, French, Hindi, Japanese, Russian, and Chinese.

## Related pages

* [Desktop App Overview](/desktop/overview) explains the desktop client and local gateway management.
* [Permission Modes](/getting-started/permissions) explains Supervised, Auto-accept edits, and Full access.
* [Client Architecture](/architecture/clients) explains the shared client core and mobile shell boundary.
* [Gateway Architecture](/architecture/gateway) explains what the mobile app connects to.
* [Protocol Layer](/architecture/protocol) explains the client/gateway contract used by mobile and other clients.
* [Protocol Introduction](/protocol/introduction) explains the protocol used by custom clients.
* [Voice API](/protocol/voice) documents mobile voice session control, binary audio chunks, and result notifications.
* [CLI Runtime API](/protocol/cli-runtime) documents Codex CLI runtime listing, model selection, approvals, and steering.