https://github.com/giggleliu/cryochamber
Cryochamber for your AI agents, for scheduling long running tasks
https://github.com/giggleliu/cryochamber
ai-agents claude-code opencode scheduler
Last synced: 2 months ago
JSON representation
Cryochamber for your AI agents, for scheduling long running tasks
- Host: GitHub
- URL: https://github.com/giggleliu/cryochamber
- Owner: GiggleLiu
- Created: 2026-02-22T17:50:21.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-20T15:31:35.000Z (3 months ago)
- Last Synced: 2026-04-20T17:24:11.704Z (3 months ago)
- Topics: ai-agents, claude-code, opencode, scheduler
- Language: Rust
- Homepage: https://giggleliu.github.io/cryochamber/
- Size: 1.66 MB
- Stars: 13
- Watchers: 0
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
[](https://crates.io/crates/cryochamber)
[](https://github.com/GiggleLiu/cryochamber/actions/workflows/ci.yml)
[](https://giggleliu.github.io/cryochamber/)
[](LICENSE)
**Cryochamber** is a hibernation chamber for AI agents (Claude, OpenCode, Codex). It hibernates an AI agent between sessions and wakes it at the right time — not on a fixed schedule. The agent checks the plan and log, completes a task, and decides when to wake next. Cryochamber empowers AI agents to run tasks that span days, weeks, or even years, like interstellar travelers in stasis.
Our goal is to automate long-running activities that are too irregular for cron. A conference deadline slips because submissions are low. A space probe's next burn window depends on orbital mechanics. A code review depends on when the author pushes fixes. Cryochamber lets an AI agent reason about *when* to wake and *what* to do next, with a persistent daemon that manages the lifecycle.
## Quick start
### Prerequisites
- The Rust toolchain. Install from [rustup.rs](https://rustup.rs).
- An AI coding agent on your `PATH`: [OpenCode](https://github.com/opencode-ai/opencode), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), or [Codex](https://github.com/openai/codex).
- macOS or Linux.
### Step 1: Install cryochamber
Install the binaries from crates.io:
```bash
cargo install cryochamber
```
This installs `cryo`, `cryo-agent`, `cryo-gh`, `cryo-zulip`, and `cryohub`.
### Step 2: Try the example chambers
Run the bundled examples (`mr-lazy`, `chess-by-mail`, `personal-assistant`) in the web dashboard.
1. Clone the repository:
```bash
git clone https://github.com/GiggleLiu/cryochamber
```
2. Change into the examples directory:
```bash
cd cryochamber/examples/chambers
```
3. Start the hub in the foreground:
```bash
cryohub start --foreground
```
4. Open the `http://host:port` URL that `cryohub` prints in your browser.
### Step 3: Create your own chamber
You have two options.
**Option A — Use the `make-plan` skill (recommended).**
If your agent supports custom skills, install the bundled skill (point your agent's skill installer at `/.claude/skills/make-plan`), then prompt your agent:
> Invoke the `make-plan` skill to create a new cryochamber project here.
The skill walks you through `plan.md` and `cryo.toml` interactively.
**Option B — Scaffold by hand.**
Copy one of `examples/chambers/*` as a starting point, or run `cryo init` in an empty directory and edit `plan.md` and `cryo.toml`.
### Step 4: Manage the running chamber
Run these from inside the chamber directory:
| Command | What it does |
|---------|--------------|
| `cryo start` | Start the daemon (installs an OS service that survives reboots). |
| `cryo status` | Show whether the daemon is running. |
| `cryo watch` | Follow the live log. |
| `cryo send "message"` | Send a message to the agent. |
| `cryo cancel` | Stop the daemon. |
For the full guide, see [Getting Started](https://giggleliu.github.io/cryochamber/getting-started.html).
## Cryohub (multi-chamber dashboard)
Cryohub is a directory-scoped web dashboard that manages every chamber under the current directory.
1. Arrange your chambers as immediate subdirectories of a workspace folder:
```text
~/my-chambers/
chess-by-mail/
mr-lazy/
reports/
```
2. Start the hub from the workspace root:
```bash
cd ~/my-chambers
cryohub start
```
3. Open the printed URL in your browser. The UI lists every chamber with a status dot and lets you send messages, wake the agent, and start, stop, or restart daemons.
See [Hub](https://giggleliu.github.io/cryochamber/hub.html) for the full reference.
## Messaging channels
Cryochamber syncs the local inbox and outbox with external messaging services through a dedicated binary per channel. The cryo daemon and agent stay channel-agnostic.
| Channel | Binary | Backend | Docs |
|--------------------|--------------|--------------------|-------------------------------------------------------------------------------|
| GitHub Discussions | `cryo-gh` | GitHub GraphQL API | [GitHub Sync](https://giggleliu.github.io/cryochamber/github-sync.html) |
| Zulip | `cryo-zulip` | Zulip REST API | [Zulip Sync](https://giggleliu.github.io/cryochamber/zulip-sync.html) |
## License
[MIT](LICENSE)