> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ccs.kaitran.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode Sync Plugin

> Use the community opencode-ccs-sync plugin to keep OpenCode aligned with your active CCS providers

# OpenCode Sync Plugin

Use the community
[`opencode-ccs-sync`](https://github.com/JasonLandbridge/opencode-ccs-sync)
plugin to keep OpenCode aligned with your live CCS setup automatically.

<Note>
  Community integration by
  [Jason Landbridge](https://github.com/JasonLandbridge).
</Note>

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

```jsonc theme={null}
{
  "$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.

## Related Docs

<CardGroup cols={2}>
  <Card title="Configuration" icon="gear" href="/getting-started/configuration">
    Understand `config.yaml` and provider settings before syncing them outward
  </Card>

  <Card title="CLI Commands" icon="terminal" href="/reference/cli-commands">
    Review `ccs env` and other third-party integration surfaces
  </Card>

  <Card title="Product Tour" icon="image" href="/getting-started/product-tour">
    See where CCS configuration and provider management live in the dashboard
  </Card>

  <Card title="Docker Deployment" icon="container-storage" href="/tutorials/docker-deployment">
    See broader CLI ecosystem integration in the containerized setup
  </Card>
</CardGroup>