← Back
davidondrej

davidondrej/cloudroom-core

Open-source, self-hostable Rust runtime for running Cloud Agents.

View on GitHub ↗https://www.cloudroom.dev ↗
Stars
229
Forks
37
Watchers
229
Open issues
8
Contributors
1
Language
Rust
License
Apache License 2.0
Default branch
main
Created Sep 17, 2026Updated Oct 1, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Cloudroom core

Website · Changelog · Security

Cloudroom core runs coding agents on your own Linux machine and saves their chat history.

  • Works with Codex, Claude Code, Pi, and Cursor.
  • Agents use your own logins to call their models.
  • One Rust service per machine. No Cloudroom account needed.

Don't want to host it yourself? Hosted Cloudroom is invite-only for now. Join the waitlist.

Cloudroom architecture: one cloud sandbox per agent, each running Cloudroom core and the agent.

Get started

  • Install on Ubuntu 24.04 with one script, on a VPS, a home server, or a spare laptop. A database on the same machine works.
  • Reach it from your laptop with Tailscale, and upgrade in place.
  • HTTP API: every endpoint, event, and error code.
  • Linux builds: tested binaries for each release.

Security

  • Agents run as a separate Linux user, with no admin rights and no sudo.
  • Agents can't read the core's token, database password, or history files.
  • Every API request needs a secret token. The API listens only on localhost unless you put it behind HTTPS.
  • History is saved to PostgreSQL: on the same machine, or on another one over verified TLS.
  • Command Guard blocks a few disastrous commands, like wiping a home folder.

Agents run without approval prompts, so give each trusted user their own machine. Report vulnerabilities privately: see SECURITY.md.

Desktop app

Download the Cloudroom app for Apple Silicon Macs (Linux alpha). Connect it to your own core with a URL and token, no account needed. The core also works without it.

Build and test

Needs Rust 1.89+, Git, and the agent CLIs you want to run.

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

Apply the two SQL files in docs/database/ to a dedicated PostgreSQL database. The core never runs migrations itself.

More docs: storage · harnesses · session lifecycle · diagnostics · dashboard API

Contributing

Issues and pull requests are welcome. For big changes, open an issue first. This is pre-release software. Licensed under Apache 2.0.