summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src
diff options
context:
space:
mode:
authororibi <[email protected]>2025-10-28 18:50:09 +0200
committerGitHub <[email protected]>2025-10-28 11:50:09 -0500
commiteb398f1951764af812c7ef01f37f01da862a852a (patch)
tree527ae6b6073263616149aa2de9fa7cf56a357c9a /packages/web/src
parent643c22d21fb438236ed9e218f085aad0c73ca8c1 (diff)
downloadopencode-eb398f1951764af812c7ef01f37f01da862a852a.tar.gz
opencode-eb398f1951764af812c7ef01f37f01da862a852a.zip
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 <[email protected]>
Diffstat (limited to 'packages/web/src')
-rw-r--r--packages/web/src/content/docs/config.mdx16
1 files changed, 16 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/config.mdx b/packages/web/src/content/docs/config.mdx
index f3b2a05a0..2a259ff37 100644
--- a/packages/web/src/content/docs/config.mdx
+++ b/packages/web/src/content/docs/config.mdx
@@ -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).