macOS · restic · Tencent Cloud COS

Back up your
Codex chats.

Keep encrypted snapshots of your local sessions, search them in your browser, and verify a restore before you need it.

Local search illustration with a query, project and status filters, and three synthetic conversations. — Local search illustration with synthetic conversations

From snapshot to recovery

run

Back up

Save incremental, restic-encrypted snapshots to a private COS bucket. Run on demand or schedule backups with a macOS LaunchAgent.

browse

Find a chat

Search active and archived conversations by keyword, project, date, or status. Export a conversation as Markdown.

restore

Restore and verify

Restore an earlier snapshot into an empty directory. The CLI checks file contents against the snapshot manifest.

Release status

The first public release, v0.1.0, is pending. Source and downloads will be available on GitHub after release.

What you’ll need

macOS, Python with SQLite FTS5, restic, rclone, zstd, and GnuPG. A private Tencent Cloud COS bucket is required for cloud backups. The local recovery drill uses synthetic data.

Back up your Codex chats.