Skip to content

Start your first session

A session is one agent working in one folder on your computer. It keeps running when your phone is away.

  1. Open the app, choose the computer, then New session.

  2. 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.

  3. Under Agent, pick Claude Code, Codex or Pi.

    New session form with a workspace picker and agent chips.New session form with a workspace picker and agent chips.
    Pick a workspace and an agent for the new session.
  4. Under Model, leave it empty for the agent’s default or type a model ID.

  5. Under Options, leave Start in Yolo mode off. What Yolo does.

  6. Type your first message and choose Create session.

    New session form with a first message typed in the composer.New session form with a first message typed in the composer.
    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.

Running session with the agent working and a stop button.Running session with the agent working and a stop button.
The agent works while you watch. Tap Stop to interrupt it.

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.