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 — это настольное приложение с открытым исходным кодом для запуска множества ИИ-агентов для программирования (например, Claude Code, Codex, Cursor) либо локально на вашем Mac, либо каждого в собственной изолированной машине в облаке. Благодаря этому они продолжают работать, даже когда вы закрыли ноутбук.
Это CLI-инструмент или настольное приложение?Это настольное приложение с графическим интерфейсом (gui/), построенное на фреймворке BB, а также отдельный сервис бэкенда на Rust (core/), который и запускает агентов в изолированной среде, локально или в облаке.
Как это запустить?Скачайте настольное приложение, и оно обновится само, или разверните ядро самостоятельно на компьютере с Linux (например, Ubuntu 24.04), а затем подключите приложение к URL и токену вашего сервера. Если не хотите разворачивать ядро сами, есть и бесплатный облачный вариант Cloudroom.
Нужны ли мне собственные аккаунты Claude или ChatGPT?Да, агенты работают на ваших собственных аккаунтах Claude и ChatGPT без наценки за токены. Если хотите собрать ядро самостоятельно, понадобится ещё Rust 1.89+.
Готово ли это к использованию на всех платформах прямо сейчас?Основная целевая платформа — Mac на Apple Silicon (macOS 13+). Поддержка Linux x64 пока находится в альфа-версии, а поддержка Windows 11 — в бета-версии.
Могут ли облачные агенты получить доступ к моему Mac и это безопасно?Облачные агенты могут по желанию получить доступ к вашему Mac с уровнем разрешений на ваш выбор (Выкл., Только чтение, Спрашивать сначала, Полный). Агенты работают как отдельный пользователь Linux без прав администратора. API слушает только localhost, если вы не поставите его за HTTPS, а история хранится на вашем собственном диске.
Что делает функция Teleport?Teleport позволяет перенести запущенный поток агента с вашего компьютера в облако и обратно, сохранив тот же чат, модель и настройки уровня усилий.
Каких агентов для программирования может запускать Cloudroom?Cloudroom построен на обвязках для агентов для программирования, таких как Claude Code, Codex, Cursor и OpenCode. Каждый агент получает общий набор навыков из папки skills/.
Зачем запускать агента в облаке, а не просто локально?Каждый облачный поток получает собственную песочницу и ветку Git, поэтому агент продолжает работать даже после того, как вы закроете ноутбук. Локальный агент так не может.
Какие есть похожие проекты?agentbox, agentmemory, memex, casbin-gateway, operator-memory, pstack-claude, nuwa-skill, golutra
Автор
davidondrej
Размер
40.6 MB
Звёзды
1.7K
Возраст
2 мес
Коммиты · 90 дней