Metadata-Version: 2.4
Name: cryopod
Version: 0.2.1
Summary: CLI for the cryopod.ai agent config backup and sync service
Project-URL: Homepage, https://cryopod.ai
Project-URL: Repository, https://github.com/cryopod/cryopod-cli
Author-email: Scott Russell <scott@artificerai.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,backup,cli,config,sync
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: click>=8.0
Requires-Dist: cryptography>=43.0
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.0
Requires-Dist: tomli-w>=1.0
Requires-Dist: tomli>=2.0; python_version < '3.11'
Description-Content-Type: text/markdown

# cryopod

[![CI](https://github.com/cryopod-ai/cryopod/actions/workflows/ci.yml/badge.svg)](https://github.com/cryopod-ai/cryopod/actions/workflows/ci.yml)

CLI for the [cryopod.ai](https://cryopod.ai) agent configuration backup and sync service.

Cryopod archives agent configuration directories, optionally encrypts them
client-side, and uploads them to the Cryopod API for backup and cross-machine
sync.

## Installation

Requires Python 3.11 or later.

```bash
pip install cryopod
```

## Quick Start

```bash
# 1. Set your API key
export CRYOPOD_API_KEY=<your-key>

# 2. Initialize a project (discovers agents, creates .cryopod.toml)
cryopod init

# 3. Archive and upload agent configs
cryopod freeze --all

# 4. Download and restore on another machine
cryopod thaw --all
```

## Configuration

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `CRYOPOD_API_KEY` | Yes (for API operations) | Sent as a Bearer token with every API request. Required for `freeze`, `thaw`, `manifest`, `purge`, and `list`. |
| `CRYOPOD_SECRET_KEY` | No | Enables client-side Fernet encryption before upload. Generate one with `cryopod keygen`. **If you lose this key, encrypted pods cannot be recovered.** |

### Project Config

Running `cryopod init` creates a `.cryopod.toml` file in the current directory.
This file tracks which agents are configured for backup in the project.

## Commands

| Command | Description |
|---------|-------------|
| `add` | Add a new agent to the local Cryopod config. |
| `freeze` | Archive and upload agent configs to Cryopod. |
| `init` | Initialize a new Cryopod project. |
| `keygen` | Generate a secret key for encrypting backups. |
| `list` | List agents with merged local and remote status. |
| `manifest` | Show pods stored on the Cryopod backend. |
| `purge` | Purge a pod from the Cryopod server. |
| `remove` | Remove an agent from the local Cryopod config. |
| `skill` | Print a markdown CLI reference for AI agents. |
| `status` | Show current Cryopod status. |
| `thaw` | Download and restore agent configs from Cryopod. |
| `update` | Update an existing agent in the local Cryopod config. |

The primary workflow is **freeze** (archive and upload) and **thaw** (download
and restore). Together they provide a round-trip backup and sync cycle for your
agent configurations.

Run `cryopod <command> --help` for detailed usage on any command.

## License

[MIT](https://opensource.org/licenses/MIT)
