cloudroom README

The project's README from github.com/davidondrej/cloudroom. As one markdown file: README.md.

Cloudroom: cloud agents must be open source. Claude Code, Codex, and Pi, on your Mac or in the cloud.

Download · Website · Changelog · Self-host · Security

GitHub stars Latest app release Apache 2.0 license

Cloudroom is a desktop app for AI coding agents. Start them on your Mac, or give each one its own computer in the cloud. Close your laptop, and they keep working.

Works with Claude Code, Codex, Pi, OpenCode, Hermes, Cursor, and Devin.

Features

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

Teleport moves a running agent between your Mac and the cloud, with the same chat, model, and effort.

What's in this repo

One repo: gui/ is the desktop app, core/ is the cloud engine, skills/ holds the agent skills.

Get started

Use the app. Download it. 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. Don't want to host it? Get hosted Cloudroom free.

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.

Cloudroom architecture: one cloud sandbox per agent, each running Cloudroom core and the agent, with the app on your Mac.

Security

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.

cloudroom (davidondrej/cloudroom)

Searching Database…

cloudroom is the open-source platform to run 1,000+ agents productively

Size
36.4 MB
Stars
1.2K
Age
1mo
Commits · 90 Days