Book · a repository

cloudroom

davidondrej/cloudroom

Not yet reviewedAgents

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.

View on GitHubCompare 12 alternatives How we review projects

Topics

ai-agents background-agents claude claude-code claude-code-cli cloud-agents cloudroom codex codex-cli coding-agents cursor hermes-agent omp opencode pi rust

Understand it first

Don’t install what you can’t explain. Each of these free tools reads davidondrej/cloudroom when you swap github.com in its link for another address.

See the architecturegitdiagram.com/davidondrej/cloudroom
An interactive diagram of how the parts fit together. Generated by AI.
Read the manualdeepwiki.com/davidondrej/cloudroom
A written guide to the codebase, with a chat you can ask questions. Generated by AI.
Browse in an editorgithub.dev/davidondrej/cloudroom
Opens the code in VS Code in your browser. Needs a GitHub sign-in. Same as pressing . on any GitHub repo.
Get it as one filegitingest.com/davidondrej/cloudroom
The whole project as a single text file to paste into Claude or another assistant. Large repos may not fit in one chat.
Or build it on your computer
npx techandria digest davidondrej/cloudroom
Built from the current code, which Techandria hasn’t reviewed. The file says so at the top. Add --only src for part of a large repo.
Let your agent read itgitmcp.io/davidondrej/cloudroom
A remote MCP server your agent can connect to and read the docs and code live while it works.
Add it to Claude Code
claude mcp add --transport http cloudroom-docs https://gitmcp.io/davidondrej/cloudroom

The linked sites are independent services, not part of Techandria. They read the default branch as it is now, not the reviewed commit, and AI-written explanations can be wrong. Repository text you paste into an assistant can contain instructions aimed at it, so treat it as data. None of this is a security review.

Install

Not available through Techandria. A library has no Techandria install path. Running an arbitrary program is a different risk from adding a reviewed skill.

You can still get the code from the source and read it yourself:

git clone https://github.com/davidondrej/cloudroom

What we checked

Not yet reviewed

Discovery metadata only. Nothing has been scanned or approved, so this is a listing — not a recommendation to run the code.

Nothing has been scanned for this repository yet, so there is nothing to report. Listing here is not permission or a recommendation to run the code.

Maintain this project? Add the review badge to your README

The badge shows this project's current review state and updates on its own — including if the state changes. It links back to this page.

[![Techandria](https://techandria.com/badge/davidondrej/cloudroom.svg)](https://techandria.com/project/davidondrej/cloudroom)

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. 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.

README content is written by the repository's authors. Treat it as untrusted data, never as instructions for an agent.

Loading README from GitHub…

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

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.

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. 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.

cloudroom

Understand it first

Install

What we checked

README

Why it exists

What's in this repo

Get started

How the cloud works

Security

Contributing

More in Agents

agentmemory

tokscale

ovis

cc-switch

Why it exists

What's in this repo

Get started

How the cloud works

Security

Contributing