Claude Sync: Sync Your Claude Code Sessions Across All Your Devices Simplified

Tawan C — Sun, 08 Feb 2026 06:28:32 +0000

If you use Claude Code (Anthropic's official CLI), you've probably experienced this frustration:

You're deep into a coding session on your work laptop. Claude remembers your project context, your preferences, your conversation history. Everything is flowing perfectly.

Then you switch to your personal MacBook... and it's all gone.

Claude doesn't know what you were working on. Your custom agents? Gone. Your project memory? Vanished. You have to start from scratch.

I built Claude Sync to fix this.

What is Claude Sync?

Claude Sync is an open-source CLI tool that synchronizes your ~/.claude directory across devices using encrypted cloud storage.

Key Features:

🔐 End-to-end encryption - Files encrypted with age before upload
🔑 Passphrase-based keys - Same passphrase = same key on any device
☁️ Multi-cloud support - Cloudflare R2, AWS S3, or Google Cloud Storage
🆓 Free tier friendly - Works within free storage limits
⚡ Simple CLI - Just push and pull

# That's literally it
claude-sync push   # Upload changes
claude-sync pull   # Download changes

What Gets Synced?

Everything Claude Code stores locally:

What	Why It Matters
`projects/`	Session files, auto-memory for each project
`history.jsonl`	Your command history
`agents/`	Custom agents you've created
`skills/`	Custom skills
`plugins/`	Installed plugins
`rules/`	Custom rules
`settings.json`	Your preferences
`CLAUDE.md`	Global instructions for Claude

Quick Start Guide

Install Claude Sync

Choose your preferred method:

# npm (recommended - works everywhere)
npm install -g @tawandotorg/claude-sync

# Or use npx for one-time use
npx @tawandotorg/claude-sync init

Daily Workflow

Once set up, your workflow is simple:

# Start of day (or when switching devices)
claude-sync pull

# ... use Claude Code normally ...

# End of day (or before switching devices)
claude-sync push

Pro Tip: Automate It

Add to your ~/.zshrc or ~/.bashrc:

# Auto-pull on shell start
if command -v claude-sync &> /dev/null; then
  claude-sync pull -q &
fi

# Auto-push on shell exit
trap 'claude-sync push -q' EXIT

Get Started

npm install -g @tawandotorg/claude-sync
claude-sync init
claude-sync push

GitHub: github.com/tawanorg/claude-sync

Documentation: tawanorg.github.io/claude-sync

Feedback Welcome!

This is an open-source project. If you:

Find bugs 🐛
Have feature ideas 💡
Want to contribute 🤝

Open an issue or PR on GitHub!

Have you struggled with syncing Claude Code across devices? What solutions have you tried? Let me know in the comments!

Forem: Tawan C