savestate
Dangerous skill: downloads and executes a remote installer via curl -fsSL https://savestate.dev/install.sh | sh and performs cloud operations to https://savestate.dev. It provides encrypted snapshots of agent state, backing up identity files like SOUL.md into .savestate/ and references SAVESTATE_API_KEY.
SaveState — Time Machine for AI
SaveState creates encrypted point-in-time snapshots of your AI agent's state — memory, identity, conversations, and configuration. Unlike live-sync tools, SaveState gives you versioned backups you can restore, compare, and migrate across platforms.
Key differentiators:
- 🔐 AES-256-GCM encryption with user-controlled keys
- 🔄 Cross-platform migration (ChatGPT → Claude → OpenClaw, etc.)
- 📊 Incremental snapshots with diff comparison
- ⏰ Scheduled automatic backups (Pro/Team)
- ☁️ Cloud storage with zero-knowledge encryption (Pro/Team)
Installation
# npm
npm install -g @savestate/cli
# Homebrew
brew tap savestatedev/tap && brew install savestate
# Direct install
curl -fsSL https://savestate.dev/install.sh | sh
Quick Start
Initialize (first time)
savestate init
This creates a .savestate/ directory with your encryption key. Back up your key — it's the only way to decrypt your snapshots.
Create a snapshot
savestate snapshot
Captures your current agent state to an encrypted archive.
List snapshots
savestate list
# or
savestate ls
Restore from snapshot
# Restore latest
savestate restore
# Restore specific snapshot
savestate restore ss-2026-02-01T12-00-00
Compare snapshots
savestate diff ss-2026-01-15 ss-2026-02-01
Platform Adapters
SaveState works with multiple AI platforms:
| Platform | Adapter | Capabilities |
|---|---|---|
| OpenClaw | openclaw | Full backup & restore |
| Claude Code | claude-code | Full backup & restore |
| OpenAI Assistants | openai-assistants | Full backup & restore |
| ChatGPT | chatgpt | Export + memory restore |
| Claude.ai | claude | Export + memory restore |
| Gemini | gemini | Export (via Takeout) |
List available adapters:
savestate adapters
Cross-Platform Migration
Migrate your AI's identity between platforms:
# Migrate from ChatGPT to Claude
savestate migrate --from chatgpt --to claude
# Restore a ChatGPT snapshot to OpenClaw
savestate restore ss-chatgpt-2026-01-15 --to openclaw
Cloud Storage (Pro/Team)
With a Pro ($9/mo) or Team ($29/mo) subscription:
# Login to SaveState cloud
savestate login
# Push snapshots to cloud
savestate cloud push
# Pull from cloud on new device
savestate cloud pull
# Schedule automatic backups
savestate schedule --every 6h
Sign up at https://savestate.dev
What Gets Backed Up
OpenClaw/Clawdbot
SOUL.md,IDENTITY.md,USER.md— Identity filesMEMORY.md,memory/*.md— Memory and daily logsTOOLS.md,HEARTBEAT.md— Configurationskills/— Installed skills and customizations- Session transcripts (optional)
Claude Code
CLAUDE.md— System prompt.claude/— Settings and memory- Project manifest and todos
ChatGPT/Claude.ai/Gemini
- Conversation history export
- Custom instructions / system prompts
- Memory entries
Automation Examples
Cron backup (OpenClaw heartbeat)
Add to HEARTBEAT.md:
## SaveState backup check
- If more than 24h since last snapshot, run: savestate snapshot
- Check with: savestate ls --json | jq '.[0].timestamp'
Pre-migration checklist
Before switching platforms:
savestate snapshot— Create fresh backupsavestate cloud push— Sync to cloud (if Pro)savestate migrate --from X --to Y— Run migration
Security
- Encryption: AES-256-GCM with Argon2id key derivation
- Zero-knowledge cloud: We only store encrypted blobs
- User-controlled keys: You own your encryption key
- No telemetry: CLI doesn't phone home
API Reference
savestate --help # Show all commands
savestate <command> --help # Command-specific help
savestate --version # Show version (currently 0.4.2)
Links
- Website: https://savestate.dev
- GitHub: https://github.com/savestatedev/savestate
- npm: https://npmjs.com/package/@savestate/cli
- Support: hello@savestate.dev
Comparison: SaveState vs Live-Sync
| Feature | SaveState | Live-sync tools |
|---|---|---|
| Point-in-time restore | ✅ | ❌ |
| Version history | ✅ | ❌ |
| Cross-platform migration | ✅ | ❌ |
| Snapshot comparison | ✅ | ❌ |
| Multi-platform support | ✅ 6 platforms | Usually 1 |
| Continuous sync | ❌ (scheduled) | ✅ |
SaveState is complementary to live-sync — use both for maximum protection.