ccsini

Sync your Claude Code settings seamlessly across all your devices. End-to-end encrypted.

Install

npm install -g ccsini
# or
bun add -g ccsini

Quick Start

# Initialize on your first device
ccsini init

# Push settings to cloud
ccsini sync push

# Pull settings on another device
ccsini sync pull

# Check sync status
ccsini sync status

Setup a New Device

Get a setup token from your dashboard, then:

ccsini init --token <your-token>

Commands

| Command | Description | |---|---| | ccsini init | Initialize ccsini on this device | | ccsini sync push | Push local settings to cloud | | ccsini sync pull | Pull settings from cloud | | ccsini sync status | Show current sync status | | ccsini sync cleanup | Remove orphaned blobs from cloud storage | | ccsini update | Update ccsini to the latest version | | ccsini version | Show current version | | ccsini doctor | Diagnose configuration issues | | ccsini reset | Wipe all server data and local config |

Cleanup

After updating ccsini, previously synced files that are now excluded (e.g. file-history/, node_modules/) may remain on the server as orphaned blobs. Use cleanup to reclaim storage:

# Preview what would be deleted
ccsini sync cleanup --dry-run

# Delete orphaned blobs (with confirmation prompt)
ccsini sync cleanup

Reset

If you need to start completely fresh (e.g. deleted devices from dashboard, stuck on old salt), reset wipes everything:

ccsini reset
# Then re-initialize
ccsini init --token <your-token>

This deletes all server-side data (salt, manifest, blobs) and your local ~/.ccsini/ config.

What Gets Synced

Only the files that matter for cross-device coding context:

| Category | Examples | |---|---| | Memory | projects/*/memory/** (MEMORY.md) | | CLAUDE.md | projects/**/CLAUDE.md | | Skills | skills/** | | Commands | commands/** | | Config | settings.json, keybindings.json, mcp.json |

Excluded from sync

• node_modules/, cache/ (at any depth)
• file-history/ (local undo data)
• tool-results/ (ephemeral tool output)
• todos/ (session task lists)
• plugins/, plans/
• *.jsonl session transcripts
• telemetry/, debug/, downloads/
• .credentials.json

Security

• Argon2id key derivation (64MB memory-hard, same as 1Password/Bitwarden)
• AES-256-GCM per-file encryption with HKDF-derived keys
• Zero-knowledge — server never sees your data
• Pure WASM crypto — no native build dependencies, works on all platforms

Requirements

• Bun runtime
• Claude Code installed on your machine

License

MIT