120 lines
3.2 KiB
Markdown
120 lines
3.2 KiB
Markdown
# 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
|
|
```
|