Skip to main content

​
OpenCode Sync Plugin

Use the community opencode-ccs-sync plugin to keep OpenCode aligned with your live CCS setup automatically.
Community integration by Jason Landbridge.
This page is the public home for the setup guidance that was preserved from the community contribution around OpenCode sync. The README keeps the attribution visible, while the actual setup steps live here so they stay public and easy to maintain.

​
What It Does

After you add the plugin and restart OpenCode, it:
  • performs an initial sync on startup
  • automatically re-syncs when ~/.ccs/config.yaml changes
  • watches live ~/.ccs/*.settings.json provider files
  • exposes only the providers and models currently selected in CCS
  • writes managed ccs-* entries into your OpenCode config

​
OpenCode Config Example

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-ccs-sync"]
}

​
Suggested Flow

  1. Configure the providers or API profiles you actually use in CCS.
  2. Install the opencode-ccs-sync plugin in OpenCode.
  3. Restart OpenCode once so the initial sync runs.
  4. Update CCS normally after that. The plugin handles re-sync from your live CCS configuration files.

​
Where This Fits

This is a community integration, not a core CCS runtime. Use it when you want OpenCode to reflect your current CCS provider selection without manually rewriting OpenCode config every time CCS changes.

Configuration

Understand config.yaml and provider settings before syncing them outward

CLI Commands

Review ccs env and other third-party integration surfaces

Product Tour

See where CCS configuration and provider management live in the dashboard

Docker Deployment

See broader CLI ecosystem integration in the containerized setup