docs: add compaction, watcher, experimental and provider options (anomalyco#6304)

Co-authored-by: OpenCode <[email protected]>
Co-authored-by: Aiden Cline <[email protected]>

Author: 3 people

packages/web/src/content/docs/config.mdx

@@ -106,7 +106,8 @@ You can configure TUI-specific settings through the `tui` option.
     "scroll_speed": 3,
     "scroll_acceleration": {
       "enabled": true
-    }
+    },
+    "diff_style": "auto"
   }
 }
 ```
@@ -115,6 +116,7 @@ Available options:
 
 - `scroll_acceleration.enabled` - Enable macOS-style scroll acceleration. **Takes precedence over `scroll_speed`.**
 - `scroll_speed` - Custom scroll speed multiplier (default: `1`, minimum: `1`). Ignored if `scroll_acceleration.enabled` is `true`.
+- `diff_style` - Control diff rendering. `"auto"` adapts to terminal width, `"stacked"` always shows single column.
 
 [Learn more about using the TUI here](/docs/tui).
 
@@ -178,6 +180,25 @@ You can configure the providers and models you want to use in your OpenCode conf
 
 The `small_model` option configures a separate model for lightweight tasks like title generation. By default, OpenCode tries to use a cheaper model if one is available from your provider, otherwise it falls back to your main model.
 
+Provider options can include `timeout` and `setCacheKey`:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "anthropic": {
+      "options": {
+        "timeout": 600000,
+        "setCacheKey": true
+      }
+    }
+  }
+}
+```
+
+- `timeout` - Request timeout in milliseconds (default: 300000). Set to `false` to disable.
+- `setCacheKey` - Ensure a cache key is always set for designated provider.
+
 You can also configure [local models](/docs/models#local). [Learn more](/docs/models).
 
 ---
@@ -363,6 +384,42 @@ For example, to ensure that the `edit` and `bash` tools require user approval:
 
 ---
 
+### Compaction
+
+You can control context compaction behavior through the `compaction` option.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "compaction": {
+    "auto": true,
+    "prune": true
+  }
+}
+```
+
+- `auto` - Automatically compact the session when context is full (default: `true`).
+- `prune` - Remove old tool outputs to save tokens (default: `true`).
+
+---
+
+### Watcher
+
+You can configure file watcher ignore patterns through the `watcher` option.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "watcher": {
+    "ignore": ["node_modules/**", "dist/**", ".git/**"]
+  }
+}
+```
+
+Patterns follow glob syntax. Use this to exclude noisy directories from file watching.
+
+---
+
 ### MCP servers
 
 You can configure MCP servers you want to use through the `mcp` option.
@@ -455,6 +512,23 @@ If a provider appears in both `enabled_providers` and `disabled_providers`, the
 
 ---
 
+### Experimental
+
+The `experimental` key contains options that are under active development.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "experimental": {}
+}
+```
+
+:::caution
+Experimental options are not stable. They may change or be removed without notice.
+:::
+
+---
+
 ## Variables
 
 You can use variable substitution in your config files to reference environment variables and file contents.