← Open Source
davidondrej

cloudroom

Cloud agents for any harness. Claude Code, Codex, Pi, and OpenCode run in isolated sandboxes, and live sessions move between your Mac and the cloud.

InfrastructureDeploy & ServeMake world agent-readyTypeScript
Open on GitHub
Momentum
+25stars in 24 hours+1.4%
1.78k
Stars
313
Forks
+162
This week
4
Contributors
Created 2026-09-17 · Updated 2026-11-19 · #675 today
Top developers
davidondrejcarrdylan52jparker2006
README

How it works · Harness adapters · Self-host · HTTP API · Download

Cloudroom runs any coding agent harness in the cloud. Claude Code, Codex, Pi, OpenCode, and others run as their own CLIs, each in an isolated sandbox with its own Git branch. A running session can move between your Mac and the cloud.

Why it exists

Coding agents like Claude Code and Codex are command-line programs. They run in one terminal, on one computer, and stop when it sleeps.

Claude Code on the web runs only Claude Code. Codex cloud runs only Codex.

Cloudroom divides the work. The harness keeps its agent loop, tools, and login. Cloudroom core, a Rust service, keeps the sandbox, the process, the queue, the recorded history, and recovery. 7 harnesses run this way today, over 4 native protocols.

Core records each harness's native session, so a running session can move. Teleport freezes it, moves its history, and resumes it on the other side, with the same chat, model, and effort.

For Apple Silicon Macs (macOS 13+), Linux x64, and Windows 11.

What's in this repo

  • gui/: the desktop app, built on BB.
  • core/: the Rust service that runs agents in the cloud and saves their history.
  • skills/: the skills every Cloudroom agent ships with.

Get started

Use the app. Download it for macOS, Windows, or Linux. It updates itself.

Host the core yourself. On Ubuntu 24.04:

curl -fsSL https://cloudroom.dev/install.sh -o install.sh
sudo bash install.sh

Then connect the app with your server's URL and token. Full guide: setup. cloudroom.dev hosts the same core for you.

Build from source. The app: see gui/README.md. The core needs Rust 1.89+:

cd core
cargo build --locked --release
cargo test --locked --all-targets

Core docs: HTTP API · storage · harnesses · session lifecycle · diagnostics · dashboard API

How the cloud works

Every Cloud thread gets its own sandbox, running Cloudroom core next to the agent. The app talks to it directly. Self-hosted, the same core runs on your own machine.

Security

  • Agents run as a separate Linux user, with no admin rights.
  • Every API request needs a secret token. The API listens only on localhost unless you put it behind HTTPS.
  • History stays on your machine's own disk.
  • Agents run without approval prompts, so give each trusted user their own machine.

Report vulnerabilities privately: see SECURITY.md.

Contributing

Issues and pull requests are welcome. For big changes, open an issue first. See CONTRIBUTING.md.

Licensed under Apache 2.0. BB's MIT notice is in NOTICE.

Nearby in the ranking
Similar items

AI Rank for iPhone

Follow AI model rankings

Download on the App Store