Session Preserve — Development skill for Claude Code

Session Preserve

**English** | [简体中文](README.zh-CN.md)

Session Preserve keeps an independent, readable copy of coding-agent sessions that are already persisted on your machine.

v0.2.0 supports four local sources: OpenAI Codex, Claude Code, Kimi Code, and ZCode.

The exported package records where its readable content came from, what the adapter could and could not establish, and a manifest of the package files. Later, session-preserve verify can check whether those manifest-attested files are still present and byte-identical to their recorded SHA-256 and size.

Source sessions are read-only. Session Preserve does not restore, resume, import, sync, reindex, repair, archive, or delete them.

If you only need a readable transcript, use the product's built-in export surface when one is available. Session Preserve is for keeping an **independent preservation package** with provenance, coverage information, and later manifest-relative integrity verification.

Install

python -m pip install session-preserve

Python 3.9 or newer. The runtime has no third-party Python dependencies.

session-preserve --help
session-preserve --version

Project pages: [GitHub](https://github.com/davidqyc/session-preserve) · [Releases](https://github.com/davidqyc/session-preserve/releases) · [Issues](https://github.com/davidqyc/session-preserve/issues)

Quick start

Every new export uses package schema 3.0.

Codex

List sanitized candidates:

session-preserve export codex --list-candidates

Export one exact persisted session:

session-preserve export codex --session-id  --output-dir ./exports

You can also select an exact rollout file with --rollout.

Claude Code

Select one top-level session JSONL explicitly:

session-preserve export claude --source ~/.claude/projects/.../.jsonl --output-dir ./exports

The default Claude Code store is under ~/.claude/projects, or $CLAUDE_CONFIG_DIR/projects when conf