Skip to main content
Running on your device means the cloud Agent remotely controls one of your computers. It reads and writes files and runs commands on that computer, using its local environment and files, with the same result as running locally. In the app, this option is called Run on your device.

Choose your device or the cloud server

Each session picks how it runs when you start it. You cannot change it afterward. For tasks that need to keep running after you close your laptop, choose the cloud server.

Let a computer run sessions

1

Sign in to the desktop app on the computer

Install the desktop app and sign in with the same account. See Download and sign in. After you sign in, the computer joins your workspace automatically. The web app does not add a device.
2

Open the machine details

Go to Settings › Workspace › Machines and click the computer. The list shows each machine’s operating system, client version, and online status.
3

Turn on Allow execution

Turn on Allow execution (off by default for computers), and review what is being loosened in the confirmation dialog. Once on, it stays in effect for all future sessions that run on this computer.
4

Adjust authorization as needed

Set the access scope, sensitive locations, and permission limit. After you save, the changes apply to new sessions right away.
Machine list

Settings › Workspace › Machines

In the machine details you can adjust:
  • Access scope: Project folders only, selected folders, or the entire computer (default).
  • Sensitive locations: For example SSH, Keychain, and system configuration. Choose Ask each time (default), Block access, or Allow access.
  • Permission limit: Session permissions cannot exceed this. Choose No limit (default), Approve for me, or Ask for approval.
  • Allowed secrets: Which workspace secrets can be used on this computer. All by default.
  • Environment variable overrides: Environment variables to override when running on this computer. Do not put plain-text secrets here.
Loosening authorization asks you to confirm. Tightening it does not. When you turn off Allow execution, sessions using this computer pause. Commands run with your account’s permissions on this computer.
Execution authorization can only be changed in the desktop app on that computer. Other devices and the web app can only view it.

Choose a device to start a session

1

Open the run environment menu

Above the new session input box, click the run environment button next to the project.
2

Pick a device

Under Run on your device, choose a computer. Each device shows its access scope and permission limit below it.
3

Send the task

Write your task and send it. Once the session starts, it stays on this computer.
  • Local projects default to the computer where the project lives. Everything else defaults to the cloud server.
  • A device cannot be selected if it is offline, Allow execution is off, the project is not on that device, or the current Agent is not Claude Code. The menu states the reason.
  • After you pick a device, permissions above its permission limit cannot be selected.
  • To switch to another computer or the cloud server, start a new session.
The first time a session runs on a computer, if Allow execution is not on yet, or the project has no matching folder on that computer, the client on that computer prompts you. Click Open Machines & access to turn on Allow execution, or click Allow and choose the project folder (the folder is not synced to the cloud). Sessions outside any project use their own temporary folder.

Confirm access to sensitive locations

When sensitive locations are set to Ask each time, the client on the running device shows the reason and the path before the Agent accesses a location such as the SSH configuration.
  • Allow once: Allows this one time only, without changing the machine authorization.
  • Deny: Does not allow it. If you do not respond for a while, it is treated as denied.
  • Respond later: Hides the prompt for now, and the session is marked in the sidebar as needing your attention.

View the execution log

At the bottom of the run environment menu, click Execution log to see this session’s actions. In the machine details, click View execution log to see actions from all sessions on this computer. Each line in the log shows what the Agent did, what it acted on, and the result. In the client on the running device, you can also stop processes, disconnect, or reconnect immediately. Elsewhere you can only view.

What happens when the computer disconnects

When the computer shuts down, sleeps, goes offline, or quits the client, the current task pauses. After the connection returns, it continues automatically from where it stopped, and completed actions are not repeated. You can also click Reconnect. On other devices and in the web app, the session is marked as device offline. A session does not move to the cloud server automatically when its device goes offline. For connection issues, see FAQ and troubleshooting.

Remove a device

At the bottom of the machine details, click Remove device and confirm.
After removal, the device disconnects immediately and sessions using it are interrupted. To use this computer again later, sign in on it again.
The cloud server cannot be removed. The computer you are currently using cannot be removed here; sign out of your account to remove it.