diff --git a/packages/app/src/i18n/en.ts b/packages/app/src/i18n/en.ts
index 218107cc29..25d4865d19 100644
--- a/packages/app/src/i18n/en.ts
+++ b/packages/app/src/i18n/en.ts
@@ -729,7 +729,7 @@ export const dict = {
   "settings.general.row.language.title": "Language",
   "settings.general.row.language.description": "Change the display language for OpenCode",
   "settings.general.row.shell.title": "Terminal Shell",
-  "settings.general.row.shell.description": "Choose the shell used for your terminal and agent tool calls.",
+  "settings.general.row.shell.description": "Choose the shell used for your terminal. Compatible shells are also used for agent tool calls.",
   "settings.general.row.shell.terminalOnly": "terminal only",
   "settings.general.row.appearance.title": "Appearance",
   "settings.general.row.appearance.description": "Customise how OpenCode looks on your device",
diff --git a/packages/opencode/test/config/config.test.ts b/packages/opencode/test/config/config.test.ts
index 65e95c0bd5..798988fb05 100644
--- a/packages/opencode/test/config/config.test.ts
+++ b/packages/opencode/test/config/config.test.ts
@@ -174,7 +174,7 @@ test("updates config and preserves empty shell sentinel", async () => {
   await Instance.provide({
     directory: tmp.path,
     fn: async () => {
-      await save({ shell: "" } as any)
+      await save({ shell: "" })
 
       const writtenConfig = await Filesystem.readJson<{ shell?: string }>(path.join(tmp.path, "config.json"))
       expect(writtenConfig.shell).toBe("")
@@ -197,7 +197,7 @@ test("updates global config and omits empty shell key in json", async () => {
   await clear(true)
 
   try {
-    await saveGlobal({ shell: "" } as any)
+    await saveGlobal({ shell: "" })
 
     const writtenConfig = await Filesystem.readJson<{ shell?: string }>(path.join(tmp.path, "opencode.json"))
     expect("shell" in writtenConfig).toBe(false)
@@ -226,7 +226,7 @@ test("updates global config and omits empty shell key in jsonc", async () => {
   await clear(true)
 
   try {
-    await saveGlobal({ shell: "" } as any)
+    await saveGlobal({ shell: "" })
 
     const file = path.join(tmp.path, "opencode.jsonc")
     const writtenConfig = await Filesystem.readText(file)
diff --git a/packages/web/src/content/docs/config.mdx b/packages/web/src/content/docs/config.mdx
index 42e06d2f57..14eefdd81c 100644
--- a/packages/web/src/content/docs/config.mdx
+++ b/packages/web/src/content/docs/config.mdx
@@ -314,7 +314,7 @@ Available options:
 
 ### Shell
 
-You can configure the shell used for the interactive terminal and agent tool calls using the `shell` option.
+You can configure the shell used for the interactive terminal using the `shell` option. Compatible shells are also used for agent tool calls.
 
 ```json title="opencode.json"
 {