From 29c344b94ca79c09d64115a8eb9e732ceba33ee8 Mon Sep 17 00:00:00 2001
From: LukeParkerDev <10430890+Hona@users.noreply.github.com>
Date: Thu, 2 Apr 2026 12:38:32 +1000
Subject: [PATCH] docs: Add terminal shell option to configuration
 documentation

---
 packages/web/src/content/docs/config.mdx | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/web/src/content/docs/config.mdx b/packages/web/src/content/docs/config.mdx
index a9c39bd59f..cca04bb4a8 100644
--- a/packages/web/src/content/docs/config.mdx
+++ b/packages/web/src/content/docs/config.mdx
@@ -211,6 +211,21 @@ Available options:
 
 ---
 
+### Shell
+
+You can configure the default shell used for the interactive terminal and the agent's background processes using the `shell` option.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "shell": "pwsh"
+}
+```
+
+If not specified, OpenCode will automatically discover and use a sensible default based on your operating system (e.g. `pwsh` or `cmd.exe` on Windows, `/bin/zsh` or `/bin/bash` on macOS/Linux). You can provide an absolute path or a short name.
+
+---
+
 ### Tools
 
 You can manage the tools an LLM can use through the `tools` option.