Create a chamber

A chamber is a directory with three files: plan.md for what the agent does, cryo.toml for chamber config, and NOTES.md for the agent’s cross-session memory. You have three ways to make one.

Option A: Use the `make-plan` skill (recommended)

If your AI agent supports custom skills, the bundled make-plan skill walks you through plan.md and cryo.toml interactively.

Install the skill in your agent. Point your agent’s skill installer at:
```
<repo>/.claude/skills/make-plan
```
Open your agent in the directory where you want the chamber. Prompt it:

Invoke the make-plan skill to create a new cryochamber project here.
Answer the agent’s questions. When the skill finishes, the directory contains plan.md, cryo.toml, and NOTES.md.

Option B: Scaffold by hand with `cryo init`

For a blank chamber:

mkdir -p ~/.cryo/chambers/my-chamber
cd ~/.cryo/chambers/my-chamber
cryo init

Then edit plan.md to describe the goal and tasks, and optionally edit cryo.toml to change the agent or session timeout. See Configuration.

Option C: Copy an example

cp -r <repo>/examples/chambers/mr-lazy ~/.cryo/chambers/my-chamber

The bundled examples are mr-lazy, chess-by-mail, and personal-assistant.

What’s in a chamber

plan.md - the goal, tasks, and any persistent state the agent should track. The agent reads this every session.
cryo.toml - chamber config: agent command, session timeout, inbox watcher. See Configuration.
NOTES.md - the agent’s persistent memory. The agent reads and appends directly; there is no IPC command for it.

For details on what these files mean and how a session uses them, see Concepts.

Next: run it

Once your chamber has plan.md and cryo.toml, follow the Tutorial from cryo start onward, or jump straight into monitoring.

Keyboard shortcuts

Cryochamber