opencodesync

Start coding on your laptop. Continue on your desktop. Never lose context.

Seamlessly sync your OpenCode settings, custom agents, and AI session contexts across all your devices.

---

The Problem

You're deep in a coding session on your work machine. You've built up context with your AI assistant - it understands your architecture, your decisions, your next steps. Then you need to switch to your home computer.

Without opencodesync: Start from scratch. Re-explain everything. Lose momentum.

With opencodesync: One command. Full context restored. Keep building.

---

Quick Start

``bash
npm install -g opencodesync
opencodesync init
`

That's it. The wizard walks you through setup and automatically syncs your settings.

First device? → Creates a new Gist and offers to push your current config
Second device? → Finds your existing Gist and offers to pull everything down

---

What You Get

$3

| What | Synced |
|------|--------|
| Main config (opencode.json) | ✅ |
| Custom agents (agent/*.md) | ✅ |
| Custom commands (command/*.md) | ✅ |
| Global instructions (AGENTS.md) | ✅ |
| Plugin configs (*.jsonc, oh-my-opencode.json) | ✅ |
| Skills directory (skills/**) | ✅ |
| Session contexts | ✅ |

$3

Export your session before switching devices:
`
/context-export "Auth Implementation" --guidance "focus on OAuth decisions"
`

Resume on any machine:
`
/context-import "Auth Implementation"
`

Your AI picks up exactly where you left off.

$3

- AES-256-GCM encryption - Your data is encrypted before it leaves your machine
- Private GitHub Gists - Only you can access your sync storage
- Zero plaintext - Even if someone gets your Gist, they can't read it without your passphrase

---

Daily Workflow

Morning at the office:
`bash
opencodesync pull # Get latest from home


... work on features ...


/context-export "Feature Progress" # Save your context
opencodesync push # Sync to cloud
`

Evening at home:
`bash
opencodesync pull # Get settings + context
/context-import "Feature Progress" # Resume with full context


... continue seamlessly ...


`

---

CLI Commands

| Command | What it does |
|---------|--------------|
| opencodesync init | Set up GitHub token and encryption passphrase |
| opencodesync push | Upload your settings to the cloud |
| opencodesync pull | Download settings from the cloud |
| opencodesync status | Check what's changed since last sync |

Use --verbose on any command for detailed output.

---

Plugin Commands (inside OpenCode)

| Command | What it does |
|---------|--------------|
| /context-export [name] | Save current session as a portable context |
| /context-import [name] | Load a saved context into your session |
| /context-list | See all your saved contexts |
| /context-prune | Delete old contexts |

---

Privacy First

Context exports are AI-generated summaries, not raw data. They capture:

- Goals and objectives
- Technical approaches and decisions
- Progress and next steps

They never include:
- Code snippets or implementations
- API keys, tokens, or secrets
- Database strings or internal URLs
- Raw file contents

Your intellectual property stays safe.

---

Troubleshooting

| Error | Solution |
|-------|----------|
| "Not configured" | Run opencodesync init |
| "Decryption failed" | Use the same passphrase as your other devices |
| "Invalid token" | Create a new GitHub token with gist scope |

Need to start fresh? opencodesync init --force && opencodesync push --force

---

For Plugin Developers

`typescript
import { createPluginTools, addContext, getAllContexts } from "opencodesync";

const tools = createPluginTools();
const context = addContext("My Context", "Summary...");
const all = getAllContexts();
``

---

License

MIT

---

Stop context-switching. Start syncing.