sessionsync 0.1.0

CLI to export and archive coding agent sessions to multiple formats.

SessionSync

SessionSync exports AI coding agent sessions to standardized file formats. It reads session data from Claude Code, OpenCode, and Pi, then converts them to Markdown, JSON, or TOON format.

Problem

AI coding agents store session data in different formats and locations. This makes it difficult to:

• Review past conversations across multiple agents
• Search and organize session history
• Share, back up or archive coding sessions
• Analyze tool usage patterns

Long sessions also cause agents to enter the "DUMB ZONE". Short sessions avoid this but lose context. SessionSync exports sessions to files so agents can read them back, giving them memory through the filesystem.

Supported Agents

• Claude Code
• OpenCode
• Pi

Export Formats

Format	Description
Markdown	Human-readable with YAML frontmatter containing session metadata
JSON	Structured data for programmatic access and analysis
TOON	Binary format for compact storage

Installation

Homebrew

brew install sessionsync

PyPI

pip install sessionsync

Or with uv:

uv tool install sessionsync

Arch Linux

yay -S sessionsync

Usage

Export all sessions from the current workspace:

sessionsync

Export sessions from a specific agent:

sessionsync --agent claude
sessionsync --agent opencode
sessionsync --agent pi

Export to a specific format:

sessionsync --format json
sessionsync --format toon

Filter by git branch:

sessionsync --branch main
sessionsync --branch all

Watch mode for continuous export:

sessionsync --watch

Options

Option	Short	Description
--agent	-a	Agent to sync: claude, opencode, pi, or all (default: all)
--output	-o	Output directory (default: .sessions)
--format	-f	Export format: markdown, json, or toon (default: markdown)
--workspace	-w	Filter by workspace path (default: current directory)
--branch	-b	Filter by git branch (default: current branch, use all for all)
--no-subagents		Exclude subagent sessions
--no-tools		Exclude tool use and result messages
--no-thinking		Exclude assistant thinking messages
--no-attachments		Exclude file attachments
--watch		Watch for changes and sync continuously
--verbose	-v	Enable debug logging

Examples

Export only main sessions without subagents:

sessionsync --no-subagents

Export without tool calls and thinking blocks:

sessionsync --no-tools --no-thinking

Export all Claude Code sessions to JSON:

sessionsync --agent claude --format json --branch all

License

MIT