https://github.com/hmennen90/claude-device-sync
Claude Code Plugin: cross-device session sync, shared memory & reminders via encrypted Git
https://github.com/hmennen90/claude-device-sync
claude-code claude-code-plugin claude-plugin cli end-to-end-encryption git reminders sync typescript
Last synced: about 2 months ago
JSON representation
Claude Code Plugin: cross-device session sync, shared memory & reminders via encrypted Git
- Host: GitHub
- URL: https://github.com/hmennen90/claude-device-sync
- Owner: hmennen90
- License: mit
- Created: 2026-04-15T10:21:23.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-19T08:05:20.000Z (about 2 months ago)
- Last Synced: 2026-04-20T19:03:32.966Z (about 2 months ago)
- Topics: claude-code, claude-code-plugin, claude-plugin, cli, end-to-end-encryption, git, reminders, sync, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/claude-device-sync
- Size: 126 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# claude-device-sync
> The first **Claude Code Plugin** with encrypted cross-device session sync, shared memory, native reminders, and team mode. Installs as a plugin, includes 5 skills, works standalone as a CLI.
[](https://www.npmjs.com/package/claude-device-sync)
[](LICENSE)
## What You Get
- **Native Claude Code Plugin** — 5 skills (`/remind`, `/resume`, `/setup`, `/status`, `/sync`) + auto-sync session hook
- **Git-backed session sync** — use any private repo (GitHub / GitLab / Gitea / self-hosted)
- **Shared memory** — sync `~/.claude/` memory files across devices
- **Reminders with DE/EN time parser** — `"morgen 9:00"`, `30m`, `2h`, `1d`, optional webhooks
- **Team mode** — per-user namespace, resume teammates' sessions
- **End-to-end encrypted** — Argon2id key derivation + ChaCha20-Poly1305
## Install
```bash
npm install -g claude-device-sync
```
**Requirements:** Node.js 20+, Git, a private Git repository (GitHub, GitLab, etc.)
## Quick Start
```bash
# 1. Initialize with your private repo
device-sync init git@github.com:you/your-sync-repo.git
# 2. Install auto-sync hooks into Claude Code
device-sync hooks install
# 3. Done! Sessions and memory sync automatically.
```
## Skills
When installed as a Claude Code plugin, the following skills become available as slash commands:
### `/setup` — Initialize device-sync
Guides you through connecting a private Git repo, choosing personal or team mode, setting a passphrase, and installing hooks.
### `/sync` — Push & pull sessions
Push or pull sessions, memory, and reminders. Supports `--memory-only` and `--session-only` flags.
### `/resume` — Continue from another device
Pulls the latest sync state, finds the most recent session, decrypts it and loads the context so you can pick up where you left off.
### `/remind` — Cross-device reminders
Set reminders with natural language time parsing (DE/EN). Supports relative (`30m`, `2h`) and absolute (`"morgen 9:00"`, `"tomorrow 14:30"`) times. Optional `--webhook` for Slack/Teams notifications.
### `/status` — Configuration & hooks
Shows sync config, registered devices, hook status, and team members. Manage hooks and team settings from here.
## CLI Reference
### Session Sync
```bash
# Push current session + memory
device-sync push
# Pull latest from remote
device-sync pull
# Resume the latest session (from any device)
device-sync resume
# List all synced sessions
device-sync sessions
# Resume a specific user's session (team mode)
device-sync resume --user colleague
```
### Reminders
```bash
# Set a reminder
device-sync remind 30m "Check deploy status"
device-sync remind 2h "Review PR"
device-sync remind "morgen 9:00" "Standup prep"
device-sync remind 1d "Release notes" --webhook https://hooks.slack.com/...
# View reminders
device-sync reminders
device-sync reminders --due
device-sync reminders --dismiss
```
### Team Mode
```bash
# Initialize in team mode
device-sync init git@github.com:team/shared-sync.git --mode team --username alice
# On another device / team member
device-sync init git@github.com:team/shared-sync.git --mode team --username bob
# Add a team member
device-sync team add charlie
# All sessions and memory are visible to all team members
device-sync sessions --user bob
device-sync resume --user alice
```
### Hooks (Auto-Sync)
```bash
# Install hooks into Claude Code settings
device-sync hooks install
# Check hook status
device-sync hooks status
# Remove hooks
device-sync hooks uninstall
```
Installed hooks:
| Event | Trigger | Action |
|-------|---------|--------|
| SessionStart | Always | `device-sync pull` |
| SessionEnd | Always | `device-sync push` |
| PostToolUse | Write/Edit | `device-sync push --memory-only` |
| PreToolUse | Always | `device-sync pull --memory-only` |
### Reminder Daemon
```bash
# Install background checker (fires webhooks for due reminders)
device-sync daemon start
# Check status
device-sync daemon status
# View logs
device-sync daemon log
# Stop daemon
device-sync daemon stop
```
### Maintenance
```bash
# View sync status
device-sync status
# Purge old sessions (default: >30 days)
device-sync purge
device-sync purge --days 14
device-sync purge --dry-run
# Purge old reminders
device-sync reminders --dismiss
```
## Encryption
All data is encrypted before being committed to Git. No plaintext ever touches the repo.
| Parameter | Value |
|-----------|-------|
| **Cipher** | ChaCha20-Poly1305 |
| **KDF** | Argon2id (64 MB memory, 3 iterations) |
| **Key storage** | OS keychain (macOS Keychain, Linux libsecret, Windows Credential Vault) |
| **Fingerprint** | Truncated SHA-256 stored in repo for password verification on new devices |
**What's encrypted:** session data, memory files, reminders — all stored as `.enc` blobs.
**What's not encrypted:** `config.json` (sync mode, device list, team member names), Git metadata.
```
Your Password
→ Argon2id + salt (stored in repo)
256-bit Key (stored in OS keychain)
→ ChaCha20-Poly1305
Encrypted .enc files → committed to private Git repo
```
Repo structure:
```
device-sync-repo/
├── config.json # Sync config (mode, devices, team members)
├── sessions/
│ ├── latest.enc # Pointer to most recent session
│ └── {user}/{device}/ # Encrypted session files
├── memory/
│ ├── {user}/{project}/ # Personal memory files
│ └── shared/{project}/ # Team-shared memory (team mode)
└── reminders/
└── pending.enc # Encrypted reminder list
```
## Platform Support
| Platform | Status | Notes |
|----------|--------|-------|
| macOS | Full support | Keychain + launchd daemon |
| Linux | Full support | libsecret + crontab daemon |
| Windows | Full support | Credential Vault + Task Scheduler daemon |
## Troubleshooting
### `GitConstructError: Cannot use simple-git on a directory that does not exist`
Fixed in 0.2.1. Upgrade with `npm install -g claude-device-sync@latest`.
### `No memory directory found` on Windows
Fixed in 0.2.2. The project-directory lookup did not strip the drive-letter colon. Upgrade to 0.2.2+.
## Marketplace
This plugin will be submitted to the Claude Code Plugin Marketplace once the marketplace is publicly available. In the meantime, install it globally via npm and the plugin is automatically discovered by Claude Code.
## License
MIT