Claude Code Sync

claude-code-sync

A Rust CLI tool for syncing Claude Code conversation history across machines using git repositories.

Documentation

📚 View API Documentation - Complete API reference and code documentation

To build and view documentation locally:

Features

Overview

claude-code-sync helps you backup and synchronize your Claude Code conversation history by pushing it to a git repository. This enables:

- Backup: Never lose your Claude Code conversations
- Multi-machine sync: Keep conversation history consistent across multiple computers
- Version control: Track changes to your conversations over time
- Conflict resolution: Automatically handles divergent conversation histories

How It Works

Claude Code stores conversation history locally in ~/.claude/projects/ as JSONL (JSON Lines) files. Each project has its own directory, and each conversation is a separate .jsonl file.

claude-code-sync:
1. Discovers all conversation files in your local Claude Code history
2. Copies them to a git repository (plus any enabled artifact categories — see Artifact Sync)
3. Commits and optionally pushes to a remote
4. On pull, merges remote changes with local history
5. Detects conflicts (same session modified on different machines)
6. Resolves conflicts by keeping both versions with renamed files

Artifact Sync

Conversation history is only part of a Claude Code environment. Artifact sync
carries the rest of ~/.claude across machines, per category:

Enable categories per machine (all default off for existing configs; the
first-run wizard pre-selects them for new setups, except hooks):

hooks is only ever switched on by name, never by all or the wizard's
defaults (see below):
claude-code-sync config --enable-artifacts hooks.

Of a file's permissions only the executable bit travels —…