.

Author: Hona

packages/app/src/pages/session/composer/session-permission-dock.tsx

@@ -14,9 +14,8 @@ export function SessionPermissionDock(props: {
 
   const toolDescription = () => {
     const key = `settings.permissions.tool.${props.request.permission}.description`
-    const fallback = props.request.permission === "shell" ? "settings.permissions.tool.bash.description" : key
     const value = language.t(key as Parameters<typeof language.t>[0])
-    if (value === key) return fallback === key ? "" : language.t(fallback as Parameters<typeof language.t>[0])
+    if (value === key) return ""
     return value
   }
 

packages/opencode/src/agent/agent.ts

@@ -166,7 +166,7 @@ export const layer = Layer.effect(
                 grep: "allow",
                 glob: "allow",
                 list: "allow",
-                shell: "allow",
+                bash: "allow",
                 webfetch: "allow",
                 websearch: "allow",
                 codesearch: "allow",

packages/opencode/src/agent/prompt/explore.txt

@@ -9,10 +9,10 @@ Guidelines:
 - Use Glob for broad file pattern matching
 - Use Grep for searching file contents with regex
 - Use Read when you know the specific file path you need to read
-- Use Shell for file operations like copying, moving, or listing directory contents
+- Use Bash for file operations like copying, moving, or listing directory contents
 - Adapt your search approach based on the thoroughness level specified by the caller
 - Return file paths as absolute paths in your final response
 - For clear communication, avoid using emojis
-- Do not create any files, or run shell commands that modify the user's system state in any way
+- Do not create any files, or run bash commands that modify the user's system state in any way
 
 Complete the user's search request efficiently and report your findings clearly.

packages/opencode/src/agent/prompt/title.txt

@@ -14,7 +14,7 @@ Your output must be:
 <rules>
 - you MUST use the same language as the user message you are summarizing
 - Title must be grammatically correct and read naturally - no word salad
-- Never include tool names in the title (e.g. "read tool", "shell tool", "edit tool")
+- Never include tool names in the title (e.g. "read tool", "bash tool", "edit tool")
 - Focus on the main topic or question the user needs to retrieve
 - Vary your phrasing - avoid repetitive patterns like always starting with "Analyzing"
 - When a file is mentioned, focus on WHAT the user wants to do WITH the file, not just that they shared it

packages/opencode/src/cli/cmd/github.ts

@@ -879,7 +879,7 @@ export const GithubRunCommand = cmd({
       function subscribeSessionEvents() {
         const TOOL: Record<string, [string, string]> = {
           todowrite: ["Todo", UI.Style.TEXT_WARNING_BOLD],
-          shell: ["Shell", UI.Style.TEXT_DANGER_BOLD],
+          bash: ["Shell", UI.Style.TEXT_DANGER_BOLD],
           edit: ["Edit", UI.Style.TEXT_SUCCESS_BOLD],
           glob: ["Glob", UI.Style.TEXT_INFO_BOLD],
           grep: ["Grep", UI.Style.TEXT_INFO_BOLD],

packages/opencode/src/cli/cmd/tui/feature-plugins/home/tips-view.tsx

@@ -95,8 +95,8 @@ const TIPS = [
   "Use {highlight}$ARGUMENTS{/highlight}, {highlight}$1{/highlight}, {highlight}$2{/highlight} in custom commands for dynamic input",
   "Use backticks in commands to inject shell output (e.g., {highlight}`git status`{/highlight})",
   "Add {highlight}.md{/highlight} files to {highlight}.opencode/agent/{/highlight} for specialized AI personas",
-  "Configure per-agent permissions for {highlight}edit{/highlight}, {highlight}shell{/highlight}, and {highlight}webfetch{/highlight} tools",
-  'Use patterns like {highlight}"git *": "allow"{/highlight} for granular shell permissions',
+  "Configure per-agent permissions for {highlight}edit{/highlight}, {highlight}bash{/highlight}, and {highlight}webfetch{/highlight} tools",
+  'Use patterns like {highlight}"git *": "allow"{/highlight} for granular bash permissions',
   'Set {highlight}"rm -rf *": "deny"{/highlight} to block destructive commands',
   'Configure {highlight}"git push": "ask"{/highlight} to require approval before pushing',
   "OpenCode auto-formats files using prettier, gofmt, ruff, and more",
@@ -130,7 +130,7 @@ const TIPS = [
   "Use {highlight}instructions{/highlight} in config to load additional rules files",
   "Set agent {highlight}temperature{/highlight} from 0.0 (focused) to 1.0 (creative)",
   "Configure {highlight}steps{/highlight} to limit agentic iterations per request",
-  'Set {highlight}"tools": {"shell": false}{/highlight} to disable specific tools',
+  'Set {highlight}"tools": {"bash": false}{/highlight} to disable specific tools',
   'Set {highlight}"mcp_*": false{/highlight} to disable all tools from an MCP server',
   "Override global tool settings per agent configuration",
   'Set {highlight}"share": "auto"{/highlight} to automatically share all sessions',

packages/opencode/test/cli/tui/transcript.test.ts

@@ -183,7 +183,7 @@ describe("transcript", () => {
         },
       }
       const result = formatPart(part, options)
-      expect(result).toContain("**Tool: shell**")
+      expect(result).toContain("**Tool: bash**")
       expect(result).toContain("**Input:**")
       expect(result).toContain('"command": "ls"')
       expect(result).toContain("**Output:**")
@@ -209,7 +209,7 @@ describe("transcript", () => {
       }
       const result = formatPart(part, options)
       // The tool header should not be inside a code block
-      expect(result).toStartWith("**Tool: shell**\n")
+      expect(result).toStartWith("**Tool: bash**\n")
       // Input and output should each be in their own code blocks
       expect(result).toContain("**Input:**\n```json")
       expect(result).toContain("**Output:**\n```\n```hello```\n```")
@@ -233,7 +233,7 @@ describe("transcript", () => {
         },
       }
       const result = formatPart(part, { ...options, toolDetails: false })
-      expect(result).toContain("**Tool: shell**")
+      expect(result).toContain("**Tool: bash**")
       expect(result).not.toContain("**Input:**")
       expect(result).not.toContain("**Output:**")
     })

packages/opencode/test/config/config.test.ts

@@ -1353,7 +1353,7 @@ test("migrates legacy tools config to permissions - allow", async () => {
     fn: async () => {
       const config = await load()
       expect(config.agent?.["test"]?.permission).toEqual({
-        shell: "allow",
+        bash: "allow",
         read: "allow",
       })
     },
@@ -1384,7 +1384,7 @@ test("migrates legacy tools config to permissions - deny", async () => {
     fn: async () => {
       const config = await load()
       expect(config.agent?.["test"]?.permission).toEqual({
-        shell: "deny",
+        bash: "deny",
         webfetch: "deny",
       })
     },
@@ -1582,7 +1582,7 @@ test("migrates mixed legacy tools config", async () => {
     fn: async () => {
       const config = await load()
       expect(config.agent?.["test"]?.permission).toEqual({
-        shell: "allow",
+        bash: "allow",
         edit: "allow",
         read: "deny",
         webfetch: "allow",