@tencent-ai/codebuddy-code 2.81.0 → 2.81.1-next.84eab07.20260409

package/dist/web-ui/docs/en/cli/tools-reference.md

@@ -25,6 +25,7 @@ CodeBuddy Code includes a set of built-in tools to help understand and modify yo
 | `LSP` | Provides code intelligence via Language Server. Automatically reports type errors and warnings after file edits. Also supports navigation operations such as go-to-definition, find references, get type info, list symbols, find implementations, and trace call hierarchies. Requires a [Code Intelligence Plugin](plugins.md) and its language server binary | No |
 | `MultiEdit` | Performs multiple edits on the same file in a single atomic operation | Yes |
 | `NotebookEdit` | Modifies Jupyter notebook cell contents | Yes |
+| `PowerShell` | Executes PowerShell commands on Windows. Only available on Windows, see [PowerShell Tool Behavior](#powershell-tool-behavior) | Yes |
 | `Read` | Reads file contents, supporting images, PDFs, and Jupyter notebooks | No |
 | `SendMessage` | Sends messages to teammates in an [Agent Team](agent-teams.md) | No |
 | `Skill` | Executes a [Skill](skills.md) in the main conversation | No |
@@ -53,6 +54,7 @@ Some tools have aliases that can be used interchangeably in permission rules:
 | :--- | :--- |
 | `TaskOutput` | `BashOutput` |
 | `TaskStop` | `KillShell` |
+| `PowerShell` | `pwsh`, `ps` |
 
 ## Bash Tool Behavior
 
@@ -73,6 +75,31 @@ The `dangerouslyDisableSandbox` parameter allows bypassing the sandbox on a per-
 
 The `run_in_background` parameter allows running commands in the background, using the `TaskOutput` tool to read the output. This is suitable for long-running builds, tests, and similar scenarios.
 
+## PowerShell Tool Behavior
+
+The PowerShell tool is only available on Windows and provides native PowerShell command execution.
+
+### Relationship with Bash Tool
+
+* **With Git Bash**: Both Bash and PowerShell tools are available; the model chooses the appropriate tool based on the scenario
+* **Without Git Bash**: The Bash tool is automatically disabled, and the PowerShell tool becomes the only shell tool
+* The PowerShell tool is not available on macOS/Linux
+
+### Version Adaptation
+
+The PowerShell tool automatically detects the PowerShell version, preferring PowerShell 7+ (pwsh) and falling back to Windows PowerShell 5.1. Syntax guidance in prompts adjusts automatically based on version differences (e.g., the `&&` operator is only supported in 7+).
+
+### Security Checks
+
+The PowerShell tool includes a built-in security checker covering dangerous patterns such as code injection, download-and-execute, privilege escalation, and system destruction. Dangerous commands (e.g., `Invoke-Expression`, `Add-Type`) are blocked, and system-modifying commands require user confirmation.
+
+### Environment Variables
+
+| Environment Variable | Description |
+|---------|------|
+| `CODEBUDDY_POWERSHELL_PATH` | Explicitly specify the PowerShell path (takes priority over auto-detection) |
+| `CODEBUDDY_USE_POWERSHELL_TOOL` | Set to `0` to disable the PowerShell tool |
+
 ## Deferred Tool Loading
 
 Some tools (such as those provided via [MCP servers](mcp.md)) use deferred loading. These tools do not appear in the initial tool list and must be discovered and activated via `ToolSearch`. Once activated, tools remain available for the rest of the session.