v0.2.1

Fixed

• zoo sync no longer strands sessions whose local JSONL was cleaned up: it falls back to the raw copy already in the repo, so metadata/markdown updates still sync instead of skipping forever

v0.2.0

Added

• zoo stats — per-session / per-model token usage and cache hit rates, persisted through sync meta.json and reindex; zoo stats --backfill for existing sessions

Fixed

• Token usage deduplicated by message.id — total_tokens no longer counts multi-block assistant messages once per block

Upgrade note: run zoo stats --backfill once to compute usage for existing sessions. The dedup fix shrinks total_tokens for most sessions, so the next zoo import marks them for a one-time re-sync.

v0.1.3

Highlights

New: Session titles in zoo list

Sessions now have a real title. zoo list shows it in a Title column instead of the noisy markdown summary excerpt, and zoo show displays it with its source label.

Title resolution follows a 4-level priority:

1. manual — set with zoo title <id> "..."
2. summary — parsed from **Title:** in the AI-generated summary
3. ai-title — extracted from Claude Code's native aiTitle records inside the jsonl
4. first-message — first user message, truncated; matches what /resume falls back to

A priority guard ensures automated processes (zoo import, zoo summarize) never overwrite a manual title. zoo title --backfill populates titles for existing sessions in one shot.

New command

zoo title <id>                # show current
zoo title <id> "新标题"       # set (manual)
zoo title <id> --reset        # clear, allow auto-derivation
zoo title --backfill          # recompute for all sessions

Sync round-trip

zoo sync writes title and title_source into meta.json; zoo reindex restores them on a new machine.

Bug fixes

• zoo restore writes Windows session jsonls to the correct ~/.claude/projects/D--work-foo/ directory (was -D-work-foo), so /resume can find restored sessions on Windows
• zoo summarize subprocess pinned to UTF-8 so Chinese summaries from claude -p no longer corrupt on Windows GBK locales

Migration

Existing DBs auto-migrate (idempotent ALTER TABLE). After upgrade, run zoo title --backfill once to populate titles from your existing jsonls.

Full diff: v0.1.2...v0.1.3

v0.1.2

What's Changed

Bug Fixes

• Windows encoding: Fix UnicodeDecodeError (GBK) — all file I/O now uses UTF-8
• TOML config: Escape backslashes in Windows paths to prevent parse errors
• Restore paths: Handle Windows drive letter colon in encoded project paths
• Hooks format: Use correct Claude Code hooks format (matcher + hooks array) — fixes "Expected array, but received undefined" error
• Empty repo sync: Skip git pull on repos with no commits

Full Changelog

v0.1.1...v0.1.2

v0.1.1

What's Changed

Windows Compatibility Fixes

• Fix UnicodeDecodeError (GBK) on Chinese Windows — all file I/O now uses UTF-8 encoding
• Fix TOML config parse error caused by unescaped backslashes in Windows paths
• Fix OSError: [WinError 123] in restore — Windows drive letter colon removed from encoded paths
• Fix git pull --rebase failure on empty repositories
• Fix cross-platform test assertions for path separators and Rich console line wrapping

v0.1.0 - Initial Release

session-zoo v0.1.0

AI development session recorder — save and sync sessions to GitHub.

Features

• Import sessions from Claude Code (Codex adapter coming soon)
• Sync sessions to GitHub with zoo sync
• Browse, search, tag, and summarize sessions
• Cross-device restore with zoo restore
• 5 bundled skills for Claude Code / Codex integration
• SessionStart hook for automatic import on session start

Install

pip install session-zoo