opencode-synced 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ian Hildebrand (hildy.io)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# opencode-synced
+
+Sync global OpenCode configuration across machines via a GitHub repo, with optional secrets support for private repos.
+
+## Features
+
+- Syncs global OpenCode config (`~/.config/opencode`) and related directories
+- Optional secrets sync when the repo is private
+- Optional session sync to share conversation history across machines
+- Optional prompt stash sync to share stashed prompts and history across machines
+- Startup auto-sync with restart toast
+- Per-machine overrides via `opencode-synced.overrides.jsonc`
+- Custom `/sync-*` commands and `opencode_sync` tool
+
+## Requirements
+
+- GitHub CLI (`gh`) installed and authenticated (`gh auth login`)
+- Git installed and available on PATH
+
+## Setup
+
+Enable the plugin in your global OpenCode config (OpenCode will install it on next run):
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-synced"],
+}
+```
+
+OpenCode does not auto-update plugins. To update, remove the cached plugin and restart OpenCode:
+
+```bash
+rm -rf ~/.cache/opencode/node_modules/opencode-synced
+opencode
+```
+
+## Configure
+
+Run `/sync-init` to get started. This will:
+
+1. Detect your GitHub username from the CLI
+2. Create a private repo (`my-opencode-config` by default) if it doesn't exist
+3. Clone the repo and set up sync
+
+That's it! Your config will now sync automatically on startup.
+
+### Custom repo name or org
+
+You can specify a custom repo name or use an organization:
+
+- `/sync-init` - Uses `{your-username}/my-opencode-config`
+- `/sync-init my-config` - Uses `{your-username}/my-config`
+- `/sync-init my-org/team-config` - Uses `my-org/team-config`
+
+<details>
+<summary>Manual configuration</summary>
+
+Create `~/.config/opencode/opencode-synced.jsonc`:
+
+```jsonc
+{
+  "repo": {
+    "owner": "your-org",
+    "name": "opencode-config",
+    "branch": "main",
+  },
+  "includeSecrets": false,
+  "includeSessions": false,
+  "includePromptStash": false,
+  "extraSecretPaths": [],
+}
+```
+
+</details>
+
+### Synced paths (default)
+
+- `~/.config/opencode/opencode.json` and `opencode.jsonc`
+- `~/.config/opencode/AGENTS.md`
+- `~/.config/opencode/agent/`, `command/`, `mode/`, `tool/`, `themes/`, `plugin/`
+
+### Secrets (private repos only)
+
+Enable secrets with `/sync-enable-secrets` or set `"includeSecrets": true`:
+
+- `~/.local/share/opencode/auth.json`
+- `~/.local/share/opencode/mcp-auth.json`
+- Any extra paths in `extraSecretPaths` (allowlist)
+
+### Sessions (private repos only)
+
+Sync your OpenCode sessions (conversation history from `/sessions`) across machines by setting `"includeSessions": true`. This requires `includeSecrets` to also be enabled since sessions may contain sensitive data.
+
+```jsonc
+{
+  "repo": { ... },
+  "includeSecrets": true,
+  "includeSessions": true
+}
+```
+
+Synced session data:
+
+- `~/.local/share/opencode/storage/session/` - Session files
+- `~/.local/share/opencode/storage/message/` - Message history
+- `~/.local/share/opencode/storage/part/` - Message parts
+- `~/.local/share/opencode/storage/session_diff/` - Session diffs
+
+### Prompt Stash (private repos only)
+
+Sync your stashed prompts and prompt history across machines by setting `"includePromptStash": true`. This requires `includeSecrets` to also be enabled since prompts may contain sensitive data.
+
+```jsonc
+{
+  "repo": { ... },
+  "includeSecrets": true,
+  "includePromptStash": true
+}
+```
+
+Synced prompt data:
+
+- `~/.local/state/opencode/prompt-stash.jsonl` - Stashed prompts
+- `~/.local/state/opencode/prompt-history.jsonl` - Prompt history
+
+## Overrides
+
+Create a local-only overrides file at:
+
+```
+~/.config/opencode/opencode-synced.overrides.jsonc
+```
+
+Overrides are merged into the runtime config and re-applied to `opencode.json(c)` after pull.
+
+## Usage
+
+- `/sync-init` to set up sync (creates repo if needed)
+- `/sync-status` for repo status and last sync
+- `/sync-pull` to fetch and apply remote config
+- `/sync-push` to commit and push local changes
+- `/sync-enable-secrets` to opt in to secrets sync
+- `/sync-resolve` to automatically resolve uncommitted changes using AI
+
+<details>
+<summary>Manual sync (without slash commands)</summary>
+
+### Trigger a sync
+
+Restart OpenCode to run the startup sync flow (pull remote, apply if changed, push local changes if needed).
+
+### Check status
+
+Inspect the local repo directly:
+
+```bash
+cd ~/.local/share/opencode/opencode-synced/repo
+git status
+git log --oneline -5
+```
+
+</details>
+
+## Recovery
+
+If the sync repo has uncommitted changes, you can:
+
+1. **Auto-resolve using AI**: Run `/sync-resolve` to let AI analyze and decide whether to commit or discard the changes
+2. **Manual resolution**: Navigate to the repo and resolve manually:
+
+```bash
+cd ~/.local/share/opencode/opencode-synced/repo
+git status
+git pull --rebase
+```
+
+Then re-run `/sync-pull` or `/sync-push`.
+
+## Development
+
+- `bun run build`
+- `bun run test`
+- `bun run lint`

package/dist/command/sync-enable-secrets.md

@@ -0,0 +1,5 @@
+---
+description: Enable secrets sync (private repo required)
+---
+Use the opencode_sync tool with command "enable-secrets".
+If the user supplies extra secret paths, pass them via extraSecretPaths.

package/dist/command/sync-init.md

@@ -0,0 +1,11 @@
+---
+description: Initialize opencode-synced configuration
+---
+
+Use the opencode_sync tool with command "init".
+The repo will be created automatically if it doesn't exist (private by default).
+Default repo name is "my-opencode-config" with owner auto-detected from GitHub CLI.
+If the user wants a custom repo name, pass name="custom-name".
+If the user wants an org-owned repo, pass owner="org-name".
+If the user wants a public repo, pass private=false.
+Include includeSecrets if the user explicitly opts in.

package/dist/command/sync-pull.md

@@ -0,0 +1,5 @@
+---
+description: Pull and apply synced OpenCode config
+---
+Use the opencode_sync tool with command "pull".
+If updates are applied, remind the user to restart OpenCode.

package/dist/command/sync-push.md

@@ -0,0 +1,4 @@
+---
+description: Push local OpenCode config to the sync repo
+---
+Use the opencode_sync tool with command "push".

package/dist/command/sync-resolve.md

@@ -0,0 +1,5 @@
+---
+description: Resolve uncommitted changes in sync repo
+---
+
+Use the opencode_sync tool with command "resolve" to automatically resolve uncommitted changes in the local sync repository using AI.

package/dist/command/sync-status.md

@@ -0,0 +1,5 @@
+---
+description: Show opencode-synced status
+---
+
+Use the opencode_sync tool with command "status" and report the results.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from '@opencode-ai/plugin';
+export declare const OpencodeConfigSync: Plugin;