diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5f1587c1..0c15dc19 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -871,7 +871,7 @@ Pages are organized by topic in `docs.json` under `navigation.dropdowns`:
 | **Overview** | index, about/overview, features, screenshots | Introduction and feature highlights |
 | **Getting Started** | installation, getting-started | Onboarding new users |
 | **Usage** | general-usage, history, context-management, autorun-playbooks, git-worktrees, group-chat, remote-access, slash-commands, speckit-commands, configuration | Feature documentation |
-| **CLI & Providers** | cli, provider-nuances | Command line and agent-specific docs |
+| **Providers & CLI** | provider-notes, cli | Provider configuration and command line docs |
 | **Reference** | achievements, keyboard-shortcuts, troubleshooting | Quick reference guides |
 
 ### Adding a New Documentation Page
diff --git a/docs/docs.json b/docs/docs.json
index 09c4235e..67670483 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -74,10 +74,10 @@
             ]
           },
           {
-            "group": "CLI & Providers",
+            "group": "Providers & CLI",
             "pages": [
-              "cli",
-              "provider-nuances"
+              "provider-notes",
+              "cli"
             ]
           },
           {
diff --git a/docs/provider-nuances.md b/docs/provider-notes.md
similarity index 62%
rename from docs/provider-nuances.md
rename to docs/provider-notes.md
index 23c7c618..bea17a41 100644
--- a/docs/provider-nuances.md
+++ b/docs/provider-notes.md
@@ -1,11 +1,39 @@
 ---
-title: Provider Nuances
+title: Provider Notes
 description: Feature differences between Claude Code, Codex (OpenAI), and OpenCode providers.
 icon: puzzle
 ---
 
 Each AI provider has unique capabilities and limitations. Maestro adapts its UI based on what each provider supports.
 
+## Custom Configuration
+
+All providers support custom command-line arguments and environment variables. Configure these in **Settings → Providers** for each agent type.
+
+<Frame>
+  <img src="./screenshots/provider-config.png" alt="Provider configuration showing custom arguments and environment variables" />
+</Frame>
+
+### Custom Arguments
+
+Additional CLI arguments are appended to every call to the agent. Common use cases:
+
+- **Claude Code**: `--model claude-sonnet-4-20250514` to specify a particular model
+- **Codex**: `-m o3` to use a specific OpenAI model
+- **OpenCode**: `--model anthropic/claude-sonnet-4-20250514` to configure the model
+
+### Environment Variables
+
+Environment variables are passed to the agent process. Use these for:
+
+- API keys and authentication tokens
+- Configuration overrides (e.g., `CLAUDE_CONFIG_DIR` for isolated Claude configurations)
+- Provider-specific settings
+
+<Note>
+The `MAESTRO_SESSION_RESUMED` variable is automatically set to `1` when resuming sessions—you don't need to configure this manually.
+</Note>
+
 ## Claude Code
 
 | Feature | Support |
@@ -49,4 +77,5 @@ Each AI provider has unique capabilities and limitations. Maestro adapts its UI
 | Context operations | ✅ Merge, export, and transfer |
 | Thinking display | ✅ Streaming text chunks |
 
-**Note**: OpenCode uses the `run` subcommand which auto-approves all permissions (similar to Codex's YOLO mode). Maestro enables this via the `OPENCODE_CONFIG_CONTENT` environment variable.
+**Notes**:
+- OpenCode uses the `run` subcommand which auto-approves all permissions (similar to Codex's YOLO mode). Maestro enables this via the `OPENCODE_CONFIG_CONTENT` environment variable.
diff --git a/docs/screenshots/provider-config.png b/docs/screenshots/provider-config.png
new file mode 100644
index 00000000..60fbcba2
Binary files /dev/null and b/docs/screenshots/provider-config.png differ