Claude Code Sync

claude-code-sync

**Secure, cross-platform CLI to sync [Claude Code](https://claude.com/claude-code) configs across machines via GitHub with [age](https://github.com/FiloSottile/age) encryption.**

[](https://github.com/felixisaac/claude-code-sync/actions/workflows/ci.yaml) [](https://github.com/felixisaac/claude-code-sync/actions/workflows/release.yaml) [](https://goreportcard.com/report/github.com/felixisaac/claude-code-sync) [](https://opensource.org/licenses/MIT)

---

Table of Contents

• Why This Exists
• Features
• Installation
• Quick Start
• Commands
• Understanding Claude Code's Directory Structure
• What Gets Synced
• Security
• How It Works
• Configuration
• Workflows
• FAQ
• Contributing
• License

---

Why This Exists

The Problem

If you use [Claude Code](https://claude.com/claude-code) across multiple machines (desktop, laptop, SSH servers), you've faced these pain points:

Pain Point	How It Manifests
Config drift	Custom commands, agents, and skills only exist on one machine
Tedious setup	Setting up a new dev environment means manually copying configs
No encryption	Can't safely store configs in git (API keys, OAuth tokens in settings.json and ~/.claude.json)
Complex tools	chezmoi requires learning file prefixes, templates, and chezmoi edit workflow
Server dependency