← 开源
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
在 GitHub 打开
增长势头
+2524 小时新增 Star+1.4%
1.78k
Star
313
Fork
+162
本周
4
贡献者
创建于 2026-09-17 · 更新于 2026-11-19 · 今日第 675 名
主要开发者
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.

排名相邻
同类项目

AI Rank iPhone 版

随时追踪 AI 模型榜单

在 App Store 下载