cloudroom README

项目的 README,来自 github.com/davidondrej/cloudroom。合并为一个 markdown 文件:README.md。

Any harness, in the cloud. Claude Code, Codex, Pi, and OpenCode each run their own CLI in an isolated sandbox, with Cloudroom core next to it. Sessions stream live to the app and teleport between your Mac and the cloud.

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

Latest app release Apache 2.0 license

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.

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

What's in this repo

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.

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)

正在搜索数据库…

这是什么?Cloudroom 是一款开源桌面应用,用来同时运行多个 AI 编程代理(如 Claude Code、Codex、Cursor)。它们可以在你的 Mac 本地运行,也可以各自运行在云端的独立沙盒机器上,因此即使你合上笔记本电脑,它们也能继续工作。
这是命令行工具还是桌面应用?它是一款桌面图形界面应用(位于 gui/ 目录,基于一个名为 BB 的框架构建),并配有一个单独的 Rust 后端服务(位于 core/ 目录)。真正在沙盒中运行代理的是这个后端,它既可以在本地运行,也可以在云端运行。
我该怎么把它跑起来?下载桌面应用即可,它会自动更新;或者你也可以在一台 Linux 机器(例如 Ubuntu 24.04)上自建核心服务,再把应用连接到你服务器的地址和令牌。如果你不想自建,也可以使用免费的 Cloudroom 托管服务。
我需要自己的 Claude 或 ChatGPT 账号吗?需要。代理使用你自己的 Claude 和 ChatGPT 账号登录运行,不会额外加收令牌费用。如果你想自己编译核心服务,还需要 Rust 1.89 或更高版本。
现在所有平台都能直接用吗?目前主要支持搭载 Apple Silicon 芯片的 Mac(macOS 13 及以上)。Linux x64 的支持仍处于 alpha 阶段,Windows 11 的支持处于 beta 阶段。
云端代理能访问我的 Mac 吗?这样安全吗?云端代理可以选择访问你的 Mac,权限级别由你决定(关闭、只读、先询问、完全访问)。代理以独立的 Linux 用户身份运行,没有管理员权限;除非你将 API 放在 HTTPS 之后,否则它只监听 localhost;历史记录则保存在你自己的磁盘上。
Teleport 功能是做什么的?Teleport 可以把正在运行的代理会话从本地机器迁移到云端,之后也能再迁回本地,同时保留原有的聊天内容、模型和推理力度设置。
Cloudroom 能运行哪些编程代理?Cloudroom 基于 Claude Code、Codex、Cursor 和 OpenCode 等编程代理框架构建,每个代理都附带 skills/ 目录中的一组共享技能。
为什么要在云端运行代理,而不只在本地运行?每个云端会话都有自己的沙盒和 Git 分支,因此即使你合上笔记本电脑,代理也能继续工作。纯本地运行的代理做不到这一点。
大小
40.6 MB
星标
1.7K
时长
2个月
提交 · 90 天