diff --git a/packages/web/src/content/docs/docs/agents.mdx b/packages/web/src/content/docs/docs/agents.mdx
index 52bb8ed1..80e1867d 100644
--- a/packages/web/src/content/docs/docs/agents.mdx
+++ b/packages/web/src/content/docs/docs/agents.mdx
@@ -1,6 +1,6 @@
 ---
 title: Agents
-description: Configure and use specialized agents in opencode.
+description: Configure and use specialized agents.
 ---
 
 Agents are specialized AI assistants that can be configured for specific tasks and workflows. They allow you to create focused tools with custom prompts, models, and tool access.
@@ -360,25 +360,13 @@ The `mode` option can be set to `primary`, `subagent`, or `all`. If no `mode` is
 
 ---
 
-### Additional options
+### Additional
 
-Any other options you specify in your agent configuration will be passed through directly to the provider as model options. This allows you to use provider-specific features and parameters.
-
-```json title="opencode.json"
-{
-  "agent": {
-    "reasoning": {
-      "model": "openai/gpt-5-turbo",
-      "reasoningEffort": "high",
-      "textVerbosity": "medium"
-    }
-  }
-}
-```
+Any other options you specify in your agent configuration will be **passed through directly** to the provider as model options. This allows you to use provider-specific features and parameters.
 
 For example, with OpenAI's reasoning models, you can control the reasoning effort:
 
-```json title="opencode.json"
+```json title="opencode.json" {6,7}
 {
   "agent": {
     "deep-thinker": {
diff --git a/packages/web/src/content/docs/docs/config.mdx b/packages/web/src/content/docs/docs/config.mdx
index 2119be5f..61a89cb1 100644
--- a/packages/web/src/content/docs/docs/config.mdx
+++ b/packages/web/src/content/docs/docs/config.mdx
@@ -71,25 +71,6 @@ Your editor should be able to validate and autocomplete based on the schema.
 
 ---
 
-### Modes
-
-opencode comes with two built-in modes: _build_, the default with all tools enabled. And _plan_, restricted mode with file modification tools disabled. You can override these built-in modes or define your own custom modes with the `mode` option.
-
-```json title="opencode.json"
-{
-  "$schema": "https://opencode.ai/config.json",
-  "mode": {
-    "build": {},
-    "plan": {},
-    "my-custom-mode": {}
-  }
-}
-```
-
-[Learn more here](/docs/modes).
-
----
-
 ### Models
 
 You can configure the providers and models you want to use in your opencode config through the `provider`, `model` and `small_model` options.