Start your first session
A session is one agent working in one folder on your computer. It keeps running when your phone is away.
Start a session
Section titled “Start a session”-
Open the app, choose the computer, then New session.
-
Under Where, pick the agent’s folder. It must be inside a folder the computer allows. Your home folder is allowed by default; add more with
remotxai workspaces add. -
Under Agent, pick Claude Code, Codex or Pi.


Pick a workspace and an agent for the new session. -
Under Model, leave it empty for the agent’s default or type a model ID.
-
Under Options, leave Start in Yolo mode off. What Yolo does.
-
Type your first message and choose Create session.


Write the first message and send it to start the session.
The agent starts on your computer and streams its messages, commands, file changes and approval requests to your phone.


Pick up a session you already started
Section titled “Pick up a session you already started”Sessions you started in a terminal show under Adoptable. Adopt moves one to the phone. Close it in the terminal first, or both write to the same conversation.
Sessions started from the phone appear under Managed.
Where to go next
Section titled “Where to go next”- Sessions and the inbox: find the session that needs you.
- Approvals and Yolo mode: decide what the agent may do without asking.
- Install the app on your phone: get notifications.