Your AI assistant
follows you everywhere.
Code Handoff is a macOS utility that syncs Claude Code sessions, conversation history, and project context across multiple Macs using your existing cloud storage. Start a project on your desktop, continue on your laptop. All your Macs become one unified workspace.
Built for developers who work from anywhere
Coffee shop. Home office. Client site. Your Claude conversations follow you seamlessly.
Shadow Sync Architecture
Claude writes to native folders - we observe and sync in the background. Drive disconnects? Claude keeps working. We only copy, never redirect.
Offline-First
Works without internet. Changes queue locally, sync when you reconnect. Licensed installs get a 72-hour offline grace period, so a week on a plane won't lock you out.
Self-Healing & Verified
A full diagnostic suite runs after every install, with a 60-day grace period before any legacy data is cleaned up. code-handoff verify re-runs the same checks on demand, and code-handoff doctor covers a broader 13-point health report.
Seamless Upgrades
Detects existing installations automatically. Migrates data safely with rollback. Your projects and OAuth credentials preserved.
Multi-Cloud Freedom
Dropbox, Google Drive, OneDrive, or iCloud. Use whatever you already have. Switch providers anytime.
Pay Once, Own Forever
No subscriptions. No recurring fees. One $9.99 purchase covers all your Macs with lifetime updates.
Keychain-Backed Security
License keys live in the macOS Keychain, not a plaintext JSON file. OAuth tokens stay local. Credentials and settings.json are deliberately excluded from sync, so your secrets never touch the cloud.
Reversible Sync
Changed your mind? code-handoff reverse safely unwinds sync on the current machine, restores the original folder layout, and leaves your data intact with an automatic snapshot first.
Cross-Machine Path Aliases
Project paths differ between your laptop and your desktop (/Users/you vs /Users/work). code-handoff alias lets you map equivalent paths so /resume can pick up a conversation from any machine, even if the folders don't line up.
Claude Never Breaks
Shadow Sync means Claude writes to its native folder - we only observe and copy. Drive disconnects mid-chat? Claude keeps working. We designed for every failure mode.
settings.json excluded from sync by design
Up and running in 3 minutes
A simple wizard guides you through setup. No command line required to get started — power users can drop into code-handoff for full control whenever they want.
Download & Launch
Open the DMG, drag to Applications. The installer auto-detects your system.
Connect Cloud
Pick your provider. Authorize in browser. Local folder detected automatically.
Activate License
Enter your key. Verification is instant. Background sync starts immediately.
Repeat on Other Macs
Same process, same license. They auto-join the sync network.
One price.
All features.
Forever.
No subscriptions, no tiers, no upsells. Just a simple tool that does exactly what you need.
Code Handoff
30-day money-back guarantee
Common questions
What is Shadow Sync?
Claude writes to native ~/.claude folders - we observe and copy to cloud in the background. If your drive disconnects, Claude keeps working. We never touch Claude's native storage.
What if my cloud drive disconnects?
Claude keeps working normally! Shadow Sync means Claude uses its own native folder. Changes queue locally and sync when your drive reconnects.
Which cloud providers are supported?
Dropbox, Google Drive, OneDrive, and iCloud. Use whichever you already have. Switch providers anytime without losing data.
What happens during upgrades?
The installer detects existing installations, preserves your OAuth credentials, migrates data safely, and runs a full post-install verification suite. Rollback is available if anything fails.
What about conflicts between machines?
Smart merge handles most cases automatically (keeps newer version). Use code-handoff conflicts for manual review when needed.
Is there a cleanup of old data?
Yes, but safely. 60-day grace period before any cleanup. Run code-handoff cleanup --status to see what's eligible. Nothing deletes automatically.
Is my conversation data secure?
Your data stays in your cloud storage — we never see it. OAuth tokens stay local. We only orchestrate sync between your own accounts.
How many Macs can I sync?
Unlimited. One license covers all your personal machines. MacBook, iMac, Mac Studio, Mac Mini — everything syncs together.