# Opencode Config Sync

Cross-machine synchronization for opencode AI configuration.

## One-Click Install

### Windows (PowerShell)

```powershell
iwr -useb https://git.nomsg.cn/chaos/opencode-config/raw/branch/master/install.ps1 | iex
```

Or manually:

```powershell
git clone https://git.nomsg.cn/chaos/opencode-config.git $env:USERPROFILE\opencode-config
cd $env:USERPROFILE\opencode-config
.\install.ps1
```

### macOS / Linux

```bash
curl -fsSL https://git.nomsg.cn/chaos/opencode-config/raw/branch/master/install.sh | bash
```

Or manually:

```bash
git clone https://git.nomsg.cn/chaos/opencode-config.git ~/.config/opencode-config
cd ~/.config/opencode-config
chmod +x install.sh
./install.sh
```

## Prerequisites

- Node.js & npm
- Python 3 (for git MCP)
- Git
- opencode CLI installed

## Environment Variables

Set these before running install, or the script will prompt you:

| Variable | Description | Required |
|----------|-------------|----------|
| `OPENCODE_API_KEY` | Your AI provider API key | Yes |
| `BRAVE_API_KEY` | Brave Search API key | No (brave-search MCP will be disabled if not set) |
| `PROJECTS_PATH` | Path to your projects directory | No (defaults: Windows=`D:\Projects`, Unix=`~/projects`) |

### Setting Env Vars (Windows)

```powershell
[Environment]::SetEnvironmentVariable("OPENCODE_API_KEY", "sk-...", "User")
[Environment]::SetEnvironmentVariable("BRAVE_API_KEY", "BSA...", "User")
```

### Setting Env Vars (Unix)

```bash
echo 'export OPENCODE_API_KEY=sk-...' >> ~/.bashrc
echo 'export BRAVE_API_KEY=BSA...' >> ~/.bashrc
```

## What's Synced

- **9 Plugins** - oh-my-openagent, opencode-mem, opencode-pty, dynamic context pruning, RAG, command-inject, notify, agent-identity, tokenscope
- **32 Skills** - Coding standards, frontend/backend patterns, security review, etc.
- **3 Agents** - explorer, reviewer, docs-researcher
- **14 MCP Servers** - codegraph, brave-search, playwright, github, context7, exa, etc.
- **Model Config** - Kimi K2.6 + 14 other models via `@ai-sdk/openai-compatible`

## Updating

```bash
cd ~/opencode-config
git pull
# Re-run install if templates changed
./install.ps1  # or ./install.sh
```

## Security Notes

- API keys are **never** committed to git
- `opencode.json` is generated locally from template
- Use a **private** GitHub repository

## Troubleshooting

**MCP not loading?**
- Restart opencode after install
- Check `opencode.json` syntax with `python -m json.tool ~/.config/opencode/opencode.json`

**CodeGraph not working?**
- Run `npm install -g @colbymchenry/codegraph` on new machine
- Run `codegraph init` in your project directory

**Git MCP fails?**
- Install Python package: `pip install mcp-server-git`

## Structure

```
opencode-config/
├── opencode.json.template    # Config template with placeholders
├── agents/                   # Agent definitions
│   ├── explorer.md
│   ├── reviewer.md
│   └── docs-researcher.md
├── skills/                   # 32 reusable skills
│   ├── coding-standards/
│   ├── frontend-patterns/
│   └── ...
├── install.ps1              # Windows installer
├── install.sh               # macOS/Linux installer
└── README.md
```