Local threads
Run Claude Code, Codex, Pi Agent, and 6 more coding agents on your own Mac, with worktrees, a terminal, diffs, and automations.
A Local thread runs an AI coding agent on your own Mac, in your project folder. It works like other desktop agent apps: pick a harness, pick a folder, and follow the agent live, with a terminal, diffs, and a browser next to the chat.
How a Local thread works
The desktop app starts the harness on your Mac, inside your project folder. The harness uses your own login and calls its model provider directly. Nothing goes through Cloudroom's servers.
flowchart LR
subgraph mac [Your Mac]
app[Cloudroom app] --> harness[Harness: Claude Code, Codex, Pi, and 6 more]
harness --> files[Your project folder]
end
harness --> model[(Your model provider)]Start a Local thread
New threads start in Cloud. Before you send the first message, pick one of these Local options in the Environment picker:
- Local: your project folder, the same one you have open in your editor.
- Local Worktree: a new folder with its own Git branch. Use it to run several agents on the same project without conflicts. Cloudroom removes the worktree when you delete its last thread.
- Personal workspace: an empty folder for work that does not belong to a project.
flowchart TB new[New thread] --> local[Local: your project folder] new --> worktree[Local Worktree: own folder and Git branch] new --> personal[Personal workspace: empty folder] new --> cloud[Cloud: its own cloud sandbox]
New threads in a project start on the machine its last thread used. To always start in Cloud, set Settings → Defaults → Starting machine to Cloud.
Harnesses
Local threads run 10 harnesses: Claude Code, Codex, Pi Agent, Cursor, OpenCode, Grok, fx, Hermes, Devin, and Droid. Install the harness on your Mac and sign in to it there. See Harnesses.
The side panel
Open the side panel next to the chat to check the agent's work without leaving the app:
- Terminal: a shell in the thread's folder.
- Git diff and Review: see every change the agent made.
- File preview: open files the agent mentions.
- Browser: open your app or any web page in a tab.
Work with a running agent
- Follow-ups: send a message while the agent works. On Local threads it steers the current turn.
- Stop: interrupts the current turn. Your history stays.
- Reasoning level: change it for the next message without starting a new thread.
- Many threads: run several agents at once, each in its own thread.
- Child threads: agents can start child threads with
room-cli, on any harness and model. Each child thread shows under its parent and opens like any other thread. See Subagents. - Side chat: ask about a message without cluttering the thread. See Side chats.
Automations
Automations run on your Mac. Each one starts a thread with a prompt or runs a stored script. Schedule it once, at a date or after a delay such as 2h, or on a repeat with a cron expression. Create and manage them in the Automations panel in the sidebar, or with room-cli loop.
Cloud automations keep running while your Mac is off, as often as every minute. See Automations.
Import your chats
Bring your Claude Code, Codex, Pi, Hermes, T3 Code, and Conductor history into Cloudroom as Local threads. Hermes chats, and T3 Code or Conductor chats from agents other than Claude Code and Codex, come over as text: the agent reads the old messages instead of resuming the session. Open Settings → Import chats, or import during onboarding. Cloudroom copies the chats and leaves the originals untouched.
Local or Cloud
Use Local when:
- You want the agent to edit the project folder you already have open in your editor.
- The task needs files, tools, or logins that only exist on your Mac.
- You want a Local Worktree, the Git diff panel, or file preview. These work only on Local threads.
Use Cloud when the work should continue after you close your laptop, or when you want to run many agents without slowing your Mac.
Move a thread to the cloud
Pick Teleport to Cloud in the thread menu, or send /teleport. The same thread continues in a cloud sandbox with its full conversation. See Teleport.