# AI use cases for Cloudroom Core (davidondrej/cloudroom-core) Repo: [davidondrej/cloudroom-core](https://github.com/davidondrej/cloudroom-core) | Use cases: 4 | Page: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/ Cloudroom core is a self-hostable Rust service that runs coding agents such as Claude Code, Codex, and Pi on a Linux machine and saves their chat history. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Run coding agents on your own Linux server: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/run-coding-agents-on-your-own-server/ - Build and test the Cloudroom core from source: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/build-and-test-the-core-from-source/ - Back up saved agent chat history: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/back-up-agent-chat-history/ - Connect the Cloudroom desktop app to your core: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/connect-desktop-app-to-own-core/ ## How to run coding agents on your own Linux server with Cloudroom Core Repo: [davidondrej/cloudroom-core](https://github.com/davidondrej/cloudroom-core) | Difficulty: Intermediate | Time: 1 hour | Basis: From the README Install the core on a VPS or home server so Claude Code and Codex run there, not on your laptop. **Who it is for:** A developer whose laptop is too slow or too busy for long agent sessions and who has a spare Ubuntu 24.04 machine. **The problem:** Agent sessions tie up a laptop, stop when the lid closes, and leave no shared place to keep their work. **The outcome:** A single Cloudroom core service on your machine that runs agents in their own room and keeps their chat history. ### Steps 1. Open the [install guide](docs/setup.md) and run the one-script install on Ubuntu 24.04. 2. Follow [reach it from your laptop](docs/setup.md#reach-it-from-your-other-devices) to connect over Tailscale. 3. Sign in to each agent CLI you plan to use with your own login, so the agent can call its model. 4. Read the [HTTP API](docs/api.md) and send a request with your secret token to create a session. 5. Check the session in the saved history and confirm the agent responded. ### Prompt to paste into your agent ```text Using the cloudroom-core repo, install the core on following docs/setup.md, then create one session for Claude Code using the HTTP API in docs/api.md. Expected output: the session ID and the agent's first reply. Verify that the API rejects a request sent without the secret token. ``` ### Caveat Agents run without approval prompts, so this setup fits only a machine that belongs to you or a user you fully trust. Risk, credentials: Agents use your own model logins on this server, so protect the secret token and the agent login files on the machine. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/run-coding-agents-on-your-own-server/ ## How to build and test the Cloudroom core from source with Cloudroom Core Repo: [davidondrej/cloudroom-core](https://github.com/davidondrej/cloudroom-core) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Compile the Rust service in release mode and run its full test suite before you deploy it. **Who it is for:** A developer or DevOps engineer who wants to verify the core builds and passes tests on their own machine before running it. **The problem:** Installing a service you have not built yourself leaves no proof that the code compiles and passes its tests on your setup. **The outcome:** A release build of the core and a passing test run, both produced from the repo on your machine. ### Steps 1. Install Git and Rust 1.89 or newer. (inferred) Use rustup to install the Rust toolchain. 2. Clone the Cloudroom Core repository from GitHub and change into its folder. 3. Run `cargo build --locked --release`. 4. Run `cargo test --locked --all-targets`. 5. Read [diagnostics](docs/observability.md) to see how to inspect the running service if you deploy it. ### Prompt to paste into your agent ```text In the cloudroom-core repo at , run `cargo build --locked --release` and then `cargo test --locked --all-targets`. Expected output: a release binary and a summary of passing tests. Verify that the test run reports zero failures before reporting success. ``` ### Caveat The README says this is pre-release software, so a passing build does not mean the core is production ready. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/build-and-test-the-core-from-source/ ## How to back up saved agent chat history with Cloudroom Core Repo: [davidondrej/cloudroom-core](https://github.com/davidondrej/cloudroom-core) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Copy the core's saved history to a backup location on a schedule you control. **Who it is for:** A team lead or ops owner who needs a record of what agents did on a server they are responsible for. **The problem:** Agent chat history lives only on one machine's disk, so a failed disk or a wiped server loses the record. **The outcome:** A backup copy of the saved history that you can restore like any other folder. ### Steps 1. Read [storage](docs/storage.md) to find where the history is kept on the machine's disk. 2. Follow the [saved history section](docs/setup.md#3-saved-history) to confirm the history folder and how to back it up. 3. Copy the history folder to your backup location, the same way you would copy any other folder. 4. Restore the copy to a test folder and check that the files are present. ### Prompt to paste into your agent ```text Using the cloudroom-core repo docs in docs/storage.md and docs/setup.md, identify the saved history folder on and copy it to . Expected output: a copy of the folder at the backup target. Verify that the file count and total size match the original. ``` ### Caveat The README says to back up history like any other folder, so you must set the backup schedule and restore process yourself. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/back-up-agent-chat-history/ ## How to connect the Cloudroom desktop app to your core with Cloudroom Core Repo: [davidondrej/cloudroom-core](https://github.com/davidondrej/cloudroom-core) | Difficulty: Intermediate | Time: 1 hour | Basis: From the README Point the Mac desktop app at your own core using a URL and token, with no account. **Who it is for:** A Mac user who runs the core on a Linux machine and wants the desktop app to control agents there. **The problem:** The desktop app runs agents on the Mac by default, but the user wants the work to run on a server they own. **The outcome:** The desktop app shows agents running on your own core, connected by URL and token. ### Steps 1. Install the core on your Linux machine by following the [install guide](docs/setup.md). 2. Reach the core from your Mac using [Tailscale](docs/setup.md#reach-it-from-your-other-devices). 3. Download the [Cloudroom app](https://github.com/davidondrej/cloudroom-gui/releases) for Apple Silicon Macs. 4. Follow [connect the desktop app](docs/setup.md#connect-the-desktop-app) and enter the core URL and token. 5. Start one agent from the app and confirm it runs on the core machine. ### Prompt to paste into your agent ```text Using the cloudroom-core setup guide in docs/setup.md, connect the Cloudroom desktop app on to the core at with the token . Expected output: the app lists the core as connected. Verify that an agent started from the app appears in the core's saved history. ``` ### Caveat The README lists the desktop app as available for Apple Silicon Macs, with Linux in alpha, so check the release page for your platform first. Risk, credentials: The desktop app needs the core's secret token, so keep the token private and do not paste it into shared notes. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/davidondrej-cloudroom-core/connect-desktop-app-to-own-core/