add OPENCODE_CONFIG_DIR to allow loading a custom config directory (#3504)

Co-authored-by: opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com>
Co-authored-by: rekram1-node <rekram1-node@users.noreply.github.com>
This commit is contained in:
oribi
2025-10-28 18:50:09 +02:00
committed by GitHub
parent 643c22d21f
commit eb398f1951
3 changed files with 22 additions and 0 deletions

View File

@@ -61,6 +61,22 @@ opencode run "Hello world"
---
### Custom directory
You can specify a custom config directory using the `OPENCODE_CONFIG_DIR`
environment variable. This directory will be searched for agents, commands,
modes, and plugins just like the standard `.opencode` directory, and should
follow the same structure.
```bash
export OPENCODE_CONFIG_DIR=/path/to/my/config-directory
opencode run "Hello world"
```
Note: The custom directory is loaded after the global config and `.opencode` directories, so it can override their settings.
---
## Schema
The config file has a schema that's defined in [**`opencode.ai/config.json`**](https://opencode.ai/config.json).