Sync your coding sessions across devices with AI-generated handoffs
Switch devices seamlessly - Claude remembers your work context across desktop, laptop, and mobile.
ConvoSync lets you work with Claude Code on one device, then continue exactly where you left off on another device. Claude generates a structured handoff document that captures:
- What you're working on
- Progress made and key decisions
- Environment setup (dependencies, env vars, services)
- Blockers and known issues
- Debug context if troubleshooting
- Next steps
Everything syncs through git - no cloud storage setup needed.
- AI-Generated Handoffs - Claude creates structured session summaries
- Git-Based Sync - Uses your existing repository, no external services
- Multi-Device Support - Works with unlimited devices, automatic cleanup
- Complete Context - Captures code AND conversation context
- Privacy First - Everything stays in your git repository
- Claude Code installed
- Git repository
The easiest way to install ConvoSync:
# Add the ConvoCLI marketplace
/plugin marketplace add convocli/convosync-plugin
# Install ConvoSync
/plugin install convosync@convocli-marketplaceOr use the interactive browser:
/plugin
# Navigate to "Browse plugins" → "convocli-marketplace" → "convosync" → "Install"That's it! The commands are now available in Claude Code.
For plugin development or if you prefer manual installation:
git clone https://github.com/convocli/convosync-plugin
cd convosync-plugin
mkdir -p .claude/commands
cp commands/*.md .claude/commands/1. Save your work:
/convosync:save "your commit message"Or simply:
/convosync:saveIf you omit the message, ConvoSync auto-generates a commit message from your handoff's "Current Task". On first run, Claude will generate a handoff automatically. Then run the command again to commit.
2. Resume on another device:
/convosync:resumeClaude displays the handoff from your other device - full context restored!
# On desktop
$ claude-code
You: Let's implement user authentication
Claude: I'll help you with that...
[working together...]
You: /convosync:save "added OAuth login"
[Claude generates handoff]
You: /convosync:save "added OAuth login"
✓ Saved to git
# Later on mobile
$ claude-code
You: /convosync:resume
✓ Handoff loaded from desktop
You: What were we working on?
Claude: We were implementing OAuth authentication.
You completed the login routes and are working
on refresh token support. I can continue from here!Want to review the handoff before committing?
/convosync:generate-handoff
[Review .convosync/session-handoff-draft.md]
/convosync:save "your message"Each handoff includes:
- Current Task - What you're working on
- Progress - Completed (✅) and in-progress (⏳) items
- Key Decisions - Technical choices and why
- Important Context - User preferences, requirements, assumptions
- Blockers - What's blocking progress
- Environment - Dependencies, env vars, services needed
- Known Issues - Shortcuts, TODOs, workarounds
- Debug Context - Errors, reproduction steps, attempts
- Next Steps - What to do next
- Files Modified - Changed files with descriptions
- Open Questions - Unresolved issues
Simple architecture:
- Claude analyzes your conversation and code
- Claude generates a structured markdown handoff
- Handoff saved to
.convosync/session-handoff.mdin your git repo - Commit and push to remote
- On another device, pull and run
/convosync:resume - Claude displays the handoff in the conversation
- Claude can now reference the handoff to continue your work
Smart cleanup:
- Each device keeps one handoff
- Old handoffs from the same device are automatically removed
- All handoffs from other devices are preserved
- Result: 1 handoff per device, scales to unlimited devices
File size:
- Full conversation: 2-5 MB
- Handoff: 2-4 KB
- 99.9% compression through AI summarization
"No handoff draft found"
This is normal on first run. The command will prompt Claude to generate one. Run /convosync:save again after Claude creates it.
"No handoffs from other devices"
You haven't saved from another device yet. Save a handoff on one device, push to git, then resume on another.
Git conflicts
If two devices save simultaneously:
git pullto see conflicts- Manually resolve (keep both handoffs)
- Commit and continue
Missing environment setup
Check the "Environment/Setup" section of the handoff - it lists all dependencies, env vars, and services needed.
your-project/
├── .convosync/
│ ├── device-id # Your device name
│ ├── session-handoff.md # All handoffs (git-tracked)
│ └── session-handoff-draft.md # Temporary (gitignored)
├── .claude/
│ └── commands/
│ ├── generate-handoff.md
│ ├── save.md
│ └── resume.md
MIT License - see LICENSE for details.
- Issues: GitHub Issues
- Documentation: CHANGELOG.md
- Repository: https://github.com/convocli/convosync-plugin
Code anywhere, anytime - with ConvoSync
Part of the ConvoCLI ecosystem