cryochamber 0.1.0

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: Rust toolchain (rustup.rs), Claude Code, macOS or Linux.

1. Install cryochamber and the make-plan skill

cargo install cryochamber
claude skill install --path skills/make-plan

2. Create a project with /make-plan

Open Claude Code and run /make-plan. The skill walks you through a guided Q&A to create your plan.md and cryo.toml — covering the task, schedule, messaging channels, provider setup, and validation. It tests the agent, verifies the config, and optionally starts the daemon for you.

3. Start the service

If the skill didn't start the daemon for you:

cryo start                                                    # start the daemon
cryo-zulip init --config ./zuliprc --stream "my-stream"       # if using Zulip
cryo-zulip sync
cryo-gh init --repo owner/repo                                # if using GitHub Discussions
cryo-gh sync
cryo web                                                      # if using the web UI
cryo watch                                                    # follow the live log

4. Manage the running service

cryo status          # check if the daemon is running
cryo watch           # follow the live log
cryo send "message"  # send a message to the agent
cryo cancel          # stop the daemon

See examples/ for complete, runnable examples (chess-by-mail, mr-lazy).

Manual setup

If you prefer to set up without the skill:

mkdir my-project && cd my-project
cryo init                          # creates plan.md, cryo.toml, AGENTS.md, README.md
vim plan.md                        # write your task plan
vim cryo.toml                      # configure agent, retries, inbox
cryo start && cryo watch           # start and monitor

Messaging Channels

Cryochamber supports external messaging channels that sync between a remote service and the local inbox/outbox directories. The cryo daemon and agent remain unaware of the channel — all sync is handled by a dedicated binary. These are configured automatically when using /make-plan.

Documentation

Full documentation is available at giggleliu.github.io/cryochamber or build locally:

make book-serve   # opens http://localhost:3000 with live reload

License

MIT