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

package/dist/web-ui/docs/en/cli/keybindings.md

@@ -0,0 +1,346 @@
+# Custom Keybindings
+
+> Customize CodeBuddy Code keyboard shortcuts through the keybindings configuration file.
+
+CodeBuddy Code supports custom keyboard shortcuts. Run the `/keybindings` command to create or open the configuration file located at `~/.codebuddy/keybindings.json`.
+
+
+## Contexts
+
+Each binding block specifies a **context** that determines when the shortcuts are active:
+
+| Context | Description |
+| :--- | :--- |
+| `Global` | Active anywhere in the application |
+| `Chat` | When the chat input box has focus |
+| `InputBox` | When a text input box is active |
+| `Terminal` | When the terminal view is active |
+| `Autocomplete` | When the autocomplete menu is displayed |
+| `Confirmation` | When a confirmation/permission dialog is displayed |
+| `HistorySearch` | When searching command history (Ctrl+R) |
+| `Task` | When a task/agent is running in the foreground |
+| `Settings` | When the settings panel is open |
+| `CommandPalette` | When the command palette is open |
+| `Select` | When a select/list component has focus |
+| `PermissionDialog` | When a tool permission dialog is displayed |
+| `Help` | When the help page is open |
+| `Plugin` | When the plugin dialog is open |
+| `DiffDialog` | When the diff dialog is open |
+| `MessageSelector` | When the message selector (rewind) is open |
+
+---
+
+## Available Actions
+
+Actions follow the `namespace:action` format, such as `chat:submit` to send a message or `app:toggleTodos` to toggle the todo list. Each context has specific available actions.
+
+### App Actions
+
+Available in the `Global` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `app:interrupt` | Ctrl+C | Interrupt the current operation |
+| `app:exit` | Ctrl+D | Exit CodeBuddy Code |
+| `app:redraw` | Ctrl+L | Refresh the terminal screen |
+| `app:toggleTodos` | Ctrl+T | Toggle the todo list |
+| `app:toggleTranscript` | Ctrl+O | Toggle verbose transcript |
+| `app:toggleSidebar` | Cmd+B | Toggle sidebar (Web UI) |
+| `app:toggleTerminal` | Cmd+J | Toggle terminal (Web UI) |
+| `app:commandPalette` | Cmd+Shift+P / Ctrl+Shift+P | Open command palette (Web UI) |
+| `app:newChat` | Cmd+N | New conversation (Web UI) |
+| `app:settings` | Cmd+, | Open settings (Web UI) |
+| `app:focusInput` | Cmd+L | Focus input box (Web UI) |
+
+### History Actions
+
+For navigating command history:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `history:search` | Ctrl+R | Open history search |
+| `history:previous` | Up | Previous history entry |
+| `history:next` | Down | Next history entry |
+
+### Chat Actions
+
+Available in the `Chat` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `chat:cancel` | Escape | Cancel current input |
+| `chat:submit` | Enter | Send message |
+| `chat:killAgents` | Ctrl+X Ctrl+K | Kill all background agents |
+| `chat:cycleMode` | Shift+Tab* | Cycle permission mode |
+| `chat:modelPicker` | Meta+P | Open model picker |
+| `chat:thinkingToggle` | Meta+T | Toggle extended thinking |
+| `chat:undo` | Ctrl+_, Ctrl+Shift+- | Undo |
+| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Open in external editor |
+| `chat:stash` | Ctrl+S | Stash current input |
+| `chat:imagePaste` | Ctrl+V (Windows: Alt+V) | Paste image |
+
+\*On Windows without VT mode (Node <24.2.0/<22.17.0, Bun <1.2.23), defaults to Meta+M.
+
+### Autocomplete Actions
+
+Available in the `Autocomplete` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `autocomplete:accept` | Tab | Accept suggestion |
+| `autocomplete:dismiss` | Escape | Dismiss menu |
+| `autocomplete:previous` | Up | Previous item |
+| `autocomplete:next` | Down | Next item |
+
+### Confirmation Actions
+
+Available in the `Confirmation` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `confirm:yes` | Y, Enter | Confirm |
+| `confirm:no` | N, Escape | Cancel |
+| `confirm:previous` | Up | Previous item |
+| `confirm:next` | Down | Next item |
+| `confirm:toggle` | Space | Toggle selection |
+| `confirm:toggleExplanation` | Ctrl+E | Toggle permission explanation |
+| `permission:toggleDebug` | Ctrl+D | Toggle permission debug info |
+
+### Transcript Actions
+
+Available in the `Transcript` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `transcript:toggleShowAll` | Ctrl+E | Toggle show all content |
+| `transcript:exit` | Q, Ctrl+C, Escape | Exit transcript view |
+
+### History Search Actions
+
+Available in the `HistorySearch` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `historySearch:next` | Ctrl+R | Next match |
+| `historySearch:accept` | Escape, Tab | Accept selection |
+| `historySearch:cancel` | Ctrl+C | Cancel search |
+| `historySearch:execute` | Enter | Execute selected command |
+
+### Task Actions
+
+Available in the `Task` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `task:background` | Ctrl+B | Send current task to background |
+
+### Help Actions
+
+Available in the `Help` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `help:dismiss` | Escape | Dismiss help menu |
+
+### Settings Actions
+
+Available in the `Settings` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `settings:search` | / | Enter search mode |
+| `settings:close` | Enter | Save and close settings panel |
+
+### Select List Actions
+
+Available in the `Select` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `select:next` | Down, J, Ctrl+N | Next item |
+| `select:previous` | Up, K, Ctrl+P | Previous item |
+| `select:accept` | Enter | Confirm selection |
+| `select:cancel` | Escape | Cancel selection |
+
+### Command Palette Actions
+
+Available in the `CommandPalette` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `commandPalette:previous` | Up | Previous item |
+| `commandPalette:next` | Down | Next item |
+| `commandPalette:execute` | Enter | Execute command |
+| `commandPalette:close` | Escape | Close palette |
+
+### Diff Actions
+
+Available in the `DiffDialog` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `diff:dismiss` | Escape | Dismiss diff viewer |
+| `diff:previousFile` | Up | Previous file |
+| `diff:nextFile` | Down | Next file |
+| `diff:viewDetails` | Enter | View details |
+
+### Message Selector Actions
+
+Available in the `MessageSelector` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `messageSelector:up` | Up, K, Ctrl+P | Move up |
+| `messageSelector:down` | Down, J, Ctrl+N | Move down |
+| `messageSelector:top` | Shift+Up | Jump to top |
+| `messageSelector:bottom` | Shift+Down | Jump to bottom |
+| `messageSelector:select` | Enter | Select message |
+
+### Plugin Actions
+
+Available in the `Plugin` context:
+
+| Action | Default Key | Description |
+| :--- | :--- | :--- |
+| `plugin:toggle` | Space | Toggle plugin selection |
+| `plugin:install` | I | Install selected plugin |
+
+---
+
+## Key Syntax
+
+### Modifiers
+
+Combine modifiers using the `+` separator:
+
+- `ctrl` or `control` — Control key
+- `alt`, `opt`, or `option` — Alt/Option key
+- `shift` — Shift key
+- `meta`, `cmd`, or `command` — Meta/Command key
+
+Examples:
+
+```
+ctrl+k          Single modifier + key
+shift+tab       Shift + Tab
+meta+p          Command/Meta + P
+ctrl+shift+c    Multiple modifiers
+```
+
+### Chords
+
+Chords are consecutive key combinations separated by spaces:
+
+```
+ctrl+x ctrl+k   Press Ctrl+X, release, then press Ctrl+K
+ctrl+x ctrl+e   Press Ctrl+X, release, then press Ctrl+E
+```
+
+Chords have a 1000ms timeout. If the second step is not completed before the timeout, the chord is cancelled.
+
+### Special Keys
+
+- `escape` or `esc` — Escape key
+- `enter` or `return` — Enter key
+- `tab` — Tab key
+- `space` — Space key
+- `up`, `down`, `left`, `right` — Arrow keys
+- `backspace`, `delete` — Delete keys
+
+---
+
+## Unbinding Default Shortcuts
+
+Set an action to `null` to unbind a default shortcut:
+
+```json
+{
+  "bindings": [
+    {
+      "context": "Chat",
+      "bindings": {
+        "ctrl+s": null
+      }
+    }
+  ]
+}
+```
+
+After unbinding all chord combinations, the prefix key can be used as a single-key binding:
+
+```json
+{
+  "bindings": [
+    {
+      "context": "Chat",
+      "bindings": {
+        "ctrl+x ctrl+k": null,
+        "ctrl+x ctrl+e": null,
+        "ctrl+x": "chat:newline"
+      }
+    }
+  ]
+}
+```
+
+If only some chord sequences are unbound, pressing the prefix key will still enter chord waiting mode.
+
+---
+
+## Reserved Shortcuts
+
+The following shortcuts cannot be rebound:
+
+| Shortcut | Reason |
+| :--- | :--- |
+| Ctrl+C | Hard-coded interrupt/cancel |
+| Ctrl+D | Hard-coded exit |
+| Ctrl+M | Equivalent to Enter in terminals (both send CR) |
+
+---
+
+## Terminal Conflicts
+
+Some shortcuts may conflict with terminal multiplexers:
+
+| Shortcut | Conflict |
+| :--- | :--- |
+| Ctrl+B | tmux prefix key (press twice to send) |
+| Ctrl+A | GNU screen prefix key |
+| Ctrl+Z | Unix process suspend (SIGTSTP) |
+
+---
+
+## Web UI Visual Configuration
+
+In addition to editing the JSON file, you can manage shortcuts through the visual interface in the Web UI:
+
+1. Click **Keybindings** in the sidebar navigation, or use the URL `#/keybindings`
+2. Use the search box to filter shortcuts by name, key, or context
+3. Click the edit button (pencil icon) to record a new shortcut combination
+4. The recording dialog shows real-time conflict detection
+5. User-customized bindings are marked with a highlighted left border
+6. Click the reset button to restore individual bindings to their defaults
+
+### REST API
+
+The Web UI manages shortcuts through the REST API:
+
+| Endpoint | Method | Description |
+| :--- | :--- | :--- |
+| `/api/v1/keybindings` | GET | Get all shortcuts (default + user + merged) |
+| `/api/v1/keybindings` | PUT | Save user shortcut configuration |
+| `/api/v1/keybindings/reset` | POST | Reset to defaults (delete user configuration) |
+| `/api/v1/keybindings/validate` | POST | Validate configuration (without saving) |
+
+---
+
+## Validation
+
+CodeBuddy Code validates your keybinding configuration and displays warnings for the following:
+
+- Parse errors (invalid JSON or structure)
+- Invalid context names
+- Reserved shortcut conflicts
+- Terminal multiplexer conflicts
+- Duplicate bindings within the same context

package/dist/web-ui/docs/en/cli/memory.md

@@ -332,9 +332,9 @@ Each project has a `MEMORY.md` index file, whose first 200 lines are automatical
 - Configure via `settings.json`: `"memory": { "autoMemoryEnabled": false }`
 - Via environment variable: `CODEBUDDY_DISABLE_AUTO_MEMORY=1`
 
-### Typed Memory Mode (Experimental)
+### Typed Memory Mode
 
-Typed Memory is an enhanced version of Auto Memory that provides a structured memory type system. When enabled, memory files are managed using YAML frontmatter and 4 types.
+Typed Memory is an enhanced version of Auto Memory that provides a structured memory type system (enabled by default). Memory files are managed using YAML frontmatter and 4 types.
 
 **4 memory types:**
 
@@ -357,13 +357,12 @@ type: user
 The user is a senior backend engineer with 10 years of Go experience, but new to the project's React frontend.
 ```
 
-**How to enable:**
+**How to disable (if you need to fall back to the general format):**
 
-- Enable `[Experimental] Typed Memory` via the `/config` panel
-- Configure via `settings.json`: `"memory": { "typedMemory": true }`
-- Via environment variable: `CODEBUDDY_TYPED_MEMORY_ENABLED=true`
+- Configure via `settings.json`: `"memory": { "typedMemory": false }`
+- Via environment variable: `CODEBUDDY_TYPED_MEMORY_ENABLED=false`
 
-> **Tip**: When Typed Memory is disabled, Auto Memory uses a simplified general format without a type system or YAML frontmatter.
+> **Tip**: Typed Memory is enabled by default. If disabled, Auto Memory uses a simplified general format without a type system or YAML frontmatter.
 
 ## Cache and Reload
 

package/dist/web-ui/docs/en/cli/release-notes/README.md

@@ -17,6 +17,9 @@ Difference from CHANGELOG.md:
 
 <!-- New versions are automatically added here -->
 
+- [v2.81.0](./v2.81.0.md) - 2026-04-08
+- [v2.80.0](./v2.80.0.md) - 2026-04-08
+- [v2.79.1](./v2.79.1.md) - 2026-04-07
 - [v2.79.0](./v2.79.0.md) - 2026-04-07
 - [v2.78.1](./v2.78.1.md) - 2026-04-05
 - [v2.78.0](./v2.78.0.md) - 2026-04-05

package/dist/web-ui/docs/en/cli/release-notes/v2.79.1.md

@@ -0,0 +1,45 @@
+# 🚀 CodeBuddy Code v2.79.1 Release
+
+## ✨ New Features
+
+### Daemon Persistent Mode & Background Sessions
+
+Added Daemon process support, manageable via `daemon start/stop/status/restart` commands for background-running CLI instances. Also supports the `--bg` parameter to start tasks in the background, with `ps/logs/attach/kill` commands for full lifecycle management of background tasks.
+
+### Web UI Workers & Log Management
+
+Web UI now includes a Workers page for visual management of all Worker processes and Daemons, supporting start/stop and terminate operations. A new standalone log viewer supports 4 log types (telemetry/process/debug/conversation) switching, keyword search, and syntax highlighting.
+
+### System Monitoring View
+
+Web UI now includes a Metrics page displaying system CPU, memory, and disk usage overview along with per-instance process-level resource metrics (RSS, Heap, uptime), with 8-second auto-polling refresh to help you stay on top of resource status.
+
+### Editor Experience Overhaul
+
+- **Tab Enhancements**: Support for drag-and-drop reordering, pinned tabs (Pin), overflow scroll arrows, and enhanced context menu (copy path, reveal in file tree, close to the right, close saved)
+- **Breadcrumb Navigation**: File path hierarchy displayed at the top of the editor, click to quickly switch between sibling files
+- **Quick Open**: Support for Cmd+P / Ctrl+P to quickly search and open files
+- **File Preview**: Support for image preview (zoom/drag/checkerboard background), Markdown, PDF, SVG preview, and binary file info page
+- **Status Bar**: Bottom bar displaying cursor position, selection info, language type, and other editor status
+- **Recent Files**: Empty editor page shows a list of recently opened files
+
+## 🔧 Improvements
+
+- **Execution Phase Tracking**: Loading status bar now shows fine-grained execution phases (preparing / waiting for model / streaming / processing / running tool), helping you understand what the Agent is currently doing
+- **Extended Background Task Support**: stream-json and headless modes now support background tasks; only print mode (`-p`) retains the original limitation
+- **Settings Page Refactoring**: Refactored into a data-driven settings panel with REST API support for reading/writing user-level settings, including toggle, select, text input, and JSON editor controls, with save feedback notification after operations
+- **Code Block Optimization**: Copy button changed to hover-floating display, language label bar removed for a cleaner interface
+- **Menu Interaction Improvements**: Slash commands, @ file completion, and + function panel now support click-outside-to-close
+
+## 🐛 Bug Fixes
+
+- **Command Completion Menu**: Fixed the issue where the completion menu remained visible while typing command arguments; the menu now correctly closes when the cursor leaves the command name area
+- **Metrics Collection**: Fixed circular API call issue with the metrics endpoint in multi-instance scenarios
+- **Session Working Directory**: Fixed the issue where Web UI session working directory was set to a URL instead of the actual path
+
+## 📝 Documentation Updates
+
+- **Daemon Usage Guide**: Added comprehensive Daemon persistent mode usage guide
+- **API Documentation**: Added documentation for new API endpoints including Workers, Daemon, and Metrics
+- **ACP Protocol Documentation**: Updated ACP protocol documentation with new features such as Team status push
+- **Release Notes Sync**: Synced v2.77.0 ~ v2.79.0 release notes to IDE documentation site

package/dist/web-ui/docs/en/cli/release-notes/v2.80.0.md

@@ -0,0 +1,33 @@
+# 🚀 CodeBuddy Code v2.80.0 Release
+
+## ✨ New Features
+
+### Native Windows PowerShell Support
+
+Added native PowerShell command execution tool that automatically detects PowerShell 7+ and Windows PowerShell 5.1 versions with adapted syntax guidance. When Git Bash is not installed, PowerShell automatically becomes the sole shell tool without crashing. Includes 24 built-in security validations covering dangerous patterns such as code injection, download-and-execute, and privilege escalation.
+
+### Memory System Overhaul
+
+- Typed Memory enabled by default, using 4 memory types (user/feedback/project/reference) for structured cross-session memory management
+- Automatically selects the most relevant memories based on user queries to inject into context, helping the AI better understand your project and preferences
+- Memories older than 1 day include a staleness warning; file paths or function names from memories trigger a reminder to verify they still exist before use
+- Supports automatic memory extraction after conversation ends (must be manually enabled in settings)
+
+### GLM-5.1 Model
+
+Added GLM-5.1 and GLM-5.1-ioa model configurations.
+
+## 🔧 Improvements
+
+- **Windows Process Management Enhancement**: Replaced simple kill with taskkill process tree termination, improving process cleanup reliability on Windows
+- **Windows Exit Code Semantics**: Correctly interprets non-standard exit codes from Windows tools such as robocopy and xcopy
+- **JSON Parameter Fix Enhancement**: Fixed the issue where `">` was incorrectly used as `":` in LLM output, causing tool call parameter parsing failures
+- **Plugin Update Resilience**: Automatically detects or reinstalls when plugin installation path is missing, preventing update failures
+- **Rating Panel Interaction**: Rating panel now only intercepts rating key presses when open, no longer disabling the entire input box
+- **Request Compatibility**: Removed trailing assistant messages without tool_calls, improving compatibility with more OpenAI-compatible APIs
+- **WeChat Work Group Chat Optimization**: Support for group chat messages prefixed with @bot-name for permission replies, auto-skip "next step suggestions" in group chats, differentiated welcome messages for group/private chats, and added [Please reply to confirm] prefix for permission confirmation messages
+
+## 🐛 Bug Fixes
+
+- **Terminal Resource Leak**: Fixed the issue where Web UI terminal PTY sessions were not cleaned up on process exit, preventing system PTY device exhaustion
+- **AskUserQuestion Defensive Improvement**: Fixed incorrect handling of empty questions/options in the component, added automatic rejection of invalid questions and filtering of empty label options

package/dist/web-ui/docs/en/cli/release-notes/v2.81.0.md

@@ -0,0 +1,40 @@
+# 🚀 CodeBuddy Code v2.81.0 Release
+
+## ✨ New Features
+
+### Command Palette
+
+Support for Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows) to open the global command palette with fuzzy search for commands, view navigation, and actions for quick access to various features.
+
+### Global Keyboard Shortcuts
+
+Added 5 global keyboard shortcuts covering command palette, sidebar toggle, terminal toggle, new conversation, and open settings, improving operational efficiency.
+
+### Toast Notification System
+
+Added a unified Toast notification component, replacing the previous silent error swallowing approach to ensure important information is not missed.
+
+### Error Boundary
+
+Added a global error boundary component to prevent a single component crash from causing the entire page to go blank, improving application stability.
+
+### Tool Process Collapsing
+
+After Agent execution completes, tool call processes automatically collapse into summary lines, keeping the conversation interface clean while allowing on-demand expansion to view details.
+
+## 🔧 Improvements
+
+- **Unified Confirm Dialog**: Added ConfirmDialog component for a consistent global confirmation interaction experience
+- **Status Bar Optimization**: Completed all view titles, added model name and connection status display for at-a-glance information
+- **Accessibility Enhancement**: Added global focus styles, ARIA role annotations, and disabled state standards to improve accessibility
+- **Mobile Adaptation**: InputBox safe area adaptation, iOS tap highlight fix, and PWA manifest support
+- **Design System Upgrade**: Added interactive state CSS variables and Tailwind design token extensions for improved visual consistency
+- **Border Contrast Fix**: Fixed nearly invisible borders in light/dark themes
+- **Plugin Marketplace Source Validation**: Added cnb.cool and cnb.woa.com as trusted sources, expanding plugin installation channels
+- **ACP Protocol Compliance**: Removed non-compliant custom message types, strictly adhering to ACP specification
+- **Default Agent Configuration**: Support for specifying the default agent via the `agent` field in `settings.json`
+
+## 🐛 Bug Fixes
+
+- **Agent Recovery After Compact**: Fixed the issue where the session incorrectly used the compact agent after context compression, ensuring subsequent conversations resume normally
+- **AskUserQuestion Input Normalization**: Fixed compatibility issues when the model returns incorrect field names or formats, with multi-point defense at both the tool layer and UI layer

package/dist/web-ui/docs/en/cli/settings.md

@@ -63,6 +63,7 @@ The `settings.json` file is the official mechanism for configuring CodeBuddy Cod
 | `hooks` | Configure custom commands to run before and after tool execution. See [hooks documentation](hooks.md) | `{"PreToolUse": {"Bash": "echo 'Running command...'"}}` |
 | `disableAllHooks` | Disable all [hooks](hooks.md) | `true` |
 | `model` | Override the default model used by CodeBuddy Code | `"gpt-5"` |
+| `agent` | Override the agent name used by the main thread (built-in or custom agent), applying that agent's system prompt, tool restrictions, and model configuration. Priority: `product.json default` → `plugin agent` → `settings.json agent` → `CLI --agent` | `"my-reviewer"` |
 | `statusLine` | Configure a custom status line to display context. See [statusLine documentation](#status-line-configuration) | `{"type": "command", "command": "~/.codebuddy/statusline.sh"}` |
 | `enableAllProjectMcpServers` | Auto-approve all MCP servers defined in the project's `.mcp.json` file | `true` |
 | `enabledMcpjsonServers` | List of specific MCP servers approved from `.mcp.json` files | `["memory", "github"]` |
@@ -95,9 +96,10 @@ Memory allows CodeBuddy Code to maintain persistent memory across sessions, auto
 
 | Key | Description | Example |
 |:------|:-----|:-----|
-| `enabled` | Whether to enable memory (default: `false`) | `true` |
 | `autoMemoryEnabled` | Whether to enable Auto Memory (default: `true`). Auto Memory allows CodeBuddy to automatically manage persistent cross-session memory, stored in `~/.codebuddy/memories/` | `true` |
-| `typedMemory` | [Experimental] Whether to enable Typed Memory mode (default: `false`). When enabled, uses 4 memory types (user/feedback/project/reference) + YAML frontmatter format | `true` |
+| `typedMemory` | Whether to enable Typed Memory mode (default: `true`). When enabled, uses 4 memory types (user/feedback/project/reference) + YAML frontmatter format for memory management | `true` |
+| `relevanceSelection` | Whether to enable memory relevance selection (default: `true`). When enabled, automatically selects up to 5 relevant memories to inject into context based on user queries | `true` |
+| `memoryExtraction` | Whether to enable background memory extraction (default: `false`). When enabled, automatically extracts information worth remembering from conversations at the end of a session | `true` |
 | `teamMemory.enabled` | Whether to enable team memory mode (default: `false`). When enabled, project memories are stored in the project directory for team sharing | `true` |
 | `teamMemory.userId` | Team user ID for isolating different users' memories. Defaults to auto-detection (git user.name > system username) | `"yangsubo"` |
 
@@ -106,9 +108,10 @@ Memory allows CodeBuddy Code to maintain persistent memory across sessions, auto
 ```json
 {
   "memory": {
-    "enabled": true,
     "autoMemoryEnabled": true,
-    "typedMemory": false,
+    "typedMemory": true,
+    "relevanceSelection": true,
+    "memoryExtraction": false,
     "teamMemory": {
       "enabled": true,
       "userId": "yangsubo"

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.