Skip to content

Profiles and accounts

A profile is one agent login on your computer, such as your work Claude Code account. Each session runs under one profile.

On the computer, run:

Terminal window
remotxai profiles add work --harness claude-code --config-dir ~/.claude-profiles/work

--harness is claude-code, codex or pi. --config-dir is that login’s settings folder. Sign in to the agent once with that folder and the profile is ready.

In the app, they’re under Computer settings, Profiles.

Settings showing the list of profiles.Settings showing the list of profiles.
Your profiles live under Profiles and models in settings.

A sub-agent on another agent runs on the profile with the same name. When several profiles stand for one account, say so on the computer:

Terminal window
remotxai profiles shared-account client3 client

Sub-agents of client3 then run on the other agent’s client profile. --clear removes it. The app shows it as Shared account in the profile’s details.

The new session screen lists the agent’s profiles under Account. If the folder has a .remotxai-profile file naming a profile, the app preselects it and tags it Folder.

Useful when an account hits its usage limit.

  1. In the session menu, choose Switch profile.

  2. Pick a profile. Rows show usage when the agent reports it.

    Profile switch sheet with the current profile and the profiles to switch to.Profile switch sheet with the current profile and the profiles to switch to.
    Open the session controls and pick the profile to move this session to.
  3. Choose Switch.

If a row says it has no usage reading, tap Reload usage at the top of the sheet. The computer reads every profile’s usage again and retries the ones that failed. A line under the title says how many profiles recovered and why any still can’t be read. A profile that needs to sign in again gets a Sign in again button on its row when this device is an admin, and plain text otherwise. If the row says the computer’s keychain is locked, unlock it on the computer and reload. Signing in again does not help there. The button is on Claude Code sessions, and a second reload within 30 seconds reads nothing new.

The agent restarts under the new profile with the same conversation and queue. If it fails to start, the session returns to the old profile.

You can’t switch while a turn is running or an approval is waiting. On Codex, the provider may refuse the first reply after a switch. If it does, switch back.

From a terminal:

Terminal window
remotxai sessions switch-profile <session-id> work

If a switch stops halfway, the session stays locked. Check which account is running, then choose Clear recovery flag on an admin device or run remotxai sessions clear-switch-recovery <session-id>.