@tencent-ai/codebuddy-code 2.80.0 → 2.81.1

package/dist/web-ui/docs/search-index-en.json

@@ -1 +1 @@
-[{"id":"/cli/overview","title":"Overview","body":"Overview Tencent Cloud Intelligent Coding Assistant Making Code Development Smarter and More Efficient CodeBuddy Code is an intelligent programming tool based on Tencent Cloud AI technology, deeply integrated with the Tencent Cloud ecosystem, providing full link AI assistance from code writing to project deployment. Why Choose CodeBuddy Code? 🚀 Drive the Entire DevOps Lifecycle with Natural Language CodeBuddy Code enables you to describe requirements in natural language and automate full link development tasks from code writing, testing, debugging, to deployment, achieving extreme automation efficiency. Whether it's a simple code modification or a complex architecture refactoring, it can be easily accomplished through conversational interaction. 🔧 Native Terminal, Seamless Integration Familiar Environment: Get AI assistance directly in your familiar command line environment, without switching development tools or learning new interfaces. Native Experience: Perfectly integrates into your existing development workflow, supporting all mainstream operating systems and terminals. Zero Learning Curve: Maintain your original development habits, with the AI assistant working silently in the background. ⚡ Powerful Out of the Box Capabilities Built in Toolchain: Integrates core development tools such as file editing, command execution, Git operations, and test execution. Intelligent Commits: Automatically generates standardized commit messages, supporting code review and change management. Flexible Expansion: Easily integrate third party tools and services through MCP (Model Context Protocol). Custom Development Tools: Customize exclusive development assistants based on project needs. 🛠️ AI Integration with Unix Philosophy Pipe Friendly: Like and , it natively supports pipe input for intelligent analysis. Script Integration: Perfectly integrates into shell scripts and automation toolchains. Compositional Capabilities: Seamlessly combines with existing Unix tools to build p"},{"id":"/cli/quickstart","title":"Quick Start Guide","body":"Quick Start Guide Welcome to CodeBuddy Code! This guide will help you get started in 5 minutes and experience a natural language driven programming assistant. 🎯 Before You Begin System Requirements Node.js: Version 18.20 or higher Operating System: macOS, Linux, or Windows Verify Your Environment ⚡ Quick Installation npm Global Installation Native Installer (Beta) ⚠️ Beta Feature: The native installer is currently in Beta. We recommend you try it to get a faster, standalone installation experience. The native installer provides an independent CodeBuddy installation without requiring a Node.js environment. Download and Install: Advantages: ✅ No Node.js dependency required ✅ Faster installation and startup Verify Installation 🔐 Login Authentication When using CodeBuddy Code for the first time, you need to complete login authentication. After startup, you will see the login method selection screen: Login Methods Login Method Use Case Description Chinese Site Users in China Authenticate via Tencent Cloud China (copilot.tencent.com), supports domestic mainstream models International Site Overseas users Authenticate via Tencent Cloud International (codebuddy.ai), supports international mainstream models Enterprise Domain Dedicated/Private deployment Connect to enterprise dedicated or self hosted CodeBuddy service, requires enterprise provided service address iOA Tencent employees Authenticate via Tencent iOA zero trust system, for Tencent internal employees only Use keys to select the login method, press to confirm, and the browser will automatically open to complete authentication. 🚀 First Experience 1. Navigate to Your Project Directory 2. Launch Interactive Mode You will see the welcome screen: Tip: If you want CodeBuddy Code to always reply in a specific language (e.g., Simplified Chinese), you can run the command after startup to set the Language option. 3. Initialize Project Context (Highly Recommended) Before starting your conversation, it is highly recommended "},{"id":"/cli/installation","title":"CodeBuddy Code Installation Guide","body":"CodeBuddy Code Installation Guide 📋 Table of Contents Installation Methods 📦 Install via Package Manager Node.js Package Managers Prerequisites: Node.js 18.20 or higher Choose your preferred package manager and run the following command: ::: code group ::: Homebrew (macOS/Linux) No Node.js required, install directly: ::: code group ::: Verify Installation After installation, run the following command to verify successful installation: ⚙️ Install via Native Binary (Beta) ⚠️ Beta Testing Phase Native binary installation is currently in Beta testing phase, and features are still being improved. If you encounter any issues, please submit an issue report on the , or contact technical support (codebuddy@tencent.com). Features Native binary installation provides the following features compared to the npm version: Single executable file with no additional dependencies No Node.js runtime required Improved automatic update mechanism Supported Platforms macOS (Apple Silicon M1/M2/M3 or Intel x8664) Linux (arm64 or x8664) Windows (x8664) Migrating from npm Version If you have already installed CodeBuddy Code via npm, you can migrate to the native binary version using the following command: Fresh Installation ::: code group ::: Verify Installation The installation script will automatically download the latest version and configure environment variables. After installation, run the following command to verify: If the command is not available, manually add the installation path to the environment variable: ::: code group ::: 🔄 Updates Automatic Updates CodeBuddy Code automatically stays up to date by default to ensure you have the latest features and security fixes. Disable Automatic Updates To disable automatic updates, set the environment variable: Manual Updates Use the following command to manually update to the latest version: The command will automatically detect your installation method and perform the corresponding update operation. Update via Package Manager If the com"},{"id":"/cli/common-workflows","title":"Common Workflows","body":"Common Workflows Learn common workflows for CodeBuddy Code. Each task in this document includes clear instructions, example commands, and best practices to help you get the most out of CodeBuddy Code. Understanding a New Codebase Getting a Quick Overview of the Codebase Suppose you've just joined a new project and need to quickly understand its structure. Steps: 1. Navigate to the project root directory 2. Start CodeBuddy Code 3. Ask for a high level overview 4. Dive into specific components Best Practices: Start with macro level questions, then narrow down to specific areas Ask about coding conventions and patterns used in the project Request a glossary of project specific terminology Finding Relevant Code Suppose you need to locate code related to a specific feature. Steps: 1. Ask CodeBuddy to find relevant files 2. Understand how components interact 3. Understand the execution flow Best Practices: Be specific about what you're looking for Use domain language from the project Refactoring Code Suppose you need to update legacy code to use modern patterns and practices. Steps: 1. Identify legacy code that needs refactoring 2. Get refactoring suggestions 3. Apply changes safely 4. Verify the refactoring Best Practices: Ask CodeBuddy to explain the benefits of modern approaches Request that changes maintain backward compatibility when needed Refactor in small, testable increments Using Plan Mode for Safe Code Analysis Plan mode instructs CodeBuddy to create a plan by analyzing the codebase through read only operations, perfect for exploring codebases, planning complex changes, or safely reviewing code. When to Use Plan Mode Multi step implementation: When your feature requires editing many files Code exploration: When you want to thoroughly research the codebase before changing anything Interactive development: When you want to iterate with CodeBuddy on the direction How to Use Plan Mode Enable plan mode during a session You can toggle to plan mode during a session us"},{"id":"/cli/interactive-mode","title":"Interactive Mode","body":"Interactive Mode Complete keyboard shortcuts, input modes, and interactive features reference for CodeBuddy Code interactive sessions. Keyboard Shortcuts <Note Keyboard shortcuts may vary by platform and terminal. Type a question mark in an interactive session to see the shortcuts available in your environment. </Note General Controls Shortcut Description Context CodeBuddy Support : : : : Cancel current input or generation Standard interrupt ✅ Supported Exit CodeBuddy Code session (when input box is empty and no conversation in progress) EOF signal, press twice to exit ✅ Supported Clear terminal screen Preserves conversation history ✅ Supported Toggle verbose output Display detailed tool usage and execution information ✅ Supported Reverse search command history Interactive search of previous commands ✅ Supported (macOS/Linux) or (Windows) Paste image from clipboard Paste image or image file path ✅ Supported Navigate command history Recall previous inputs ✅ Supported + Rewind code/conversation Restore code and/or conversation to previous state (requires pressing ESC twice consecutively when the input box is empty) ✅ Supported Toggle thinking mode Switch between thinking on and thinking off ✅ Supported (macOS/Linux) or (Windows) Toggle permission mode Switch between auto accept, plan, and normal modes ✅ Supported (macOS) or (Windows/Linux) Switch model Quickly open model selection panel ✅ Supported Notes: + rewind functionality is now supported: when the input box is empty, pressing the ESC key twice consecutively activates the feature, allowing you to quickly revert code or conversation to a previous state key in CodeBuddy Code is primarily used for auto completion, with partial support for thinking mode toggle (macOS/Linux) or (Windows) is used to toggle permission modes, including normal mode, auto accept edits mode, skip permissions mode, and plan mode. Note: On Windows, you must use ; does not work Multi line Input Method Shortcut Context CodeBuddy Support : : : "},{"id":"/cli/headless","title":"Headless Mode","body":"Headless Mode Run CodeBuddy Code programmatically without an interactive UI Overview Headless mode allows you to run CodeBuddy Code programmatically through command line scripts and automation tools without any interactive UI. Headless mode also supports scheduled task capabilities. In script, SDK, or server side integration scenarios, you can use tools such as , , and to create, view, and cancel scheduled tasks. ⚠️ Important Note: (or ) is a required parameter for non interactive mode. When using the parameter for non interactive execution, this parameter must be added to perform operations that require authorization (file read/write, command execution, network requests, etc.), otherwise these operations will be blocked. Only use this parameter in trusted environments and explicit task scenarios. See for details. Basic Usage The primary command line interface for CodeBuddy Code is the (or ) command. Use the (or ) flag to run in non interactive mode and print the final result: Configuration Options Headless mode leverages all available CLI options in CodeBuddy Code. Here are key options for automation and scripting: Flag Description Example : : : , Run in non interactive mode Specify output format ( , , ) , Resume a conversation by session ID , Continue the most recent conversation Enable verbose logging Append to system prompt (only works with ) List of allowed tools, space separated or<br / <br / comma separated string <br / <br / List of disallowed tools, space separated or<br / <br / comma separated string <br / <br / Load additional settings configuration from a JSON file or JSON string Specify which settings sources to load (options: , , ) Load MCP servers from a JSON file MCP tool for handling permission prompts (only works with ) ❌ Not supported Note: The feature is currently not supported. For a complete list of CLI options and features, please refer to the documentation. Multi turn Conversations For multi turn conversations, you can resume a conversation o"},{"id":"/cli/troubleshooting","title":"Troubleshooting and Best Practices","body":"Troubleshooting and Best Practices This document covers common problem solutions and usage optimization tips. Common Issues Shared Quota CLI, CodeBuddy IDE, and CodeBuddy Plugin share the same account's resource quota. ESC Key Not Working in JetBrains IDE JetBrains terminal handles the ESC key differently. Use or instead. Action Standard Terminal JetBrains Terminal Exit/Cancel or Model Switching serve Mode Network Access Issues LAN IP Access Returns Symptom: After starting with , accessing via LAN IP (e.g., ) results in in the browser. Cause: The HTTP server listens on (loopback address) by default, accepting only local connections. When accessing via LAN IP, the request reaches the machine but is rejected by the service. Solution: Add the parameter at startup to listen on all network interfaces: Password authentication is automatically enabled when starting on a non loopback address. The password is visible in the console output. Verify Service Listening Status You can check if the service is listening correctly with: If showing — accepts local connections only If showing or — accepts all network connections Migrating from Claude Code Migration Content Directory/File Description Custom agents configuration Slash command definitions Skill definitions AI instructions and memory documents Option 1: Symbolic Links (Recommended) Share configuration; changes in one place take effect in both. Option 2: Copy Files Independent configuration; changes don't affect each other. One Click Plugin Skills Installation Skills from Claude Code plugins support one click installation and are automatically loaded after installation. Verify Migration Cost Optimization Core Principles Use to start a new session for new tasks Use to compress history for long conversations Use to reference files instead of pasting code Session Management Commands Command Function View token consumption Start a new session Compress history Resume a previous conversation Cost Comparison Approach Input Tokens "},{"id":"/cli/best-practices","title":"CodeBuddy Code Best Practices","body":"CodeBuddy Code Best Practices From configuring your environment to parallel scaling, master the techniques and patterns that make CodeBuddy Code work at its best. CodeBuddy Code is an intelligent programming environment. Unlike traditional Q&A assistants, CodeBuddy can read files, execute commands, modify code, and autonomously solve problems while you observe, guide, or step away. This changes how you work. Instead of writing code yourself and asking for review, you describe goals and let CodeBuddy explore, plan, and implement. This guide covers patterns that have proven effective across various codebases, languages, and environments. Give CodeBuddy Ways to Verify Its Work Core Advice: Provide tests, screenshots, or expected outputs so CodeBuddy can self check. This is the single practice that improves results the most. CodeBuddy performs significantly better when it can verify its own work—running tests, comparing screenshots, validating outputs. Without clear success criteria, it may produce results that look correct but don't actually work. You become the only feedback loop, and every mistake requires your attention. Strategy Before After Provide verification criteria \"Implement a function that validates emails\" \"Write a validateEmail function. Test cases: user@example.com returns true, invalid returns false, user@.com returns false. Run the tests after implementing\" Verify UI changes visually \"Make the dashboard look better\" \"[paste screenshot] Implement this design. After finishing, take a screenshot and compare with the original, list differences and fix them\" Address root causes \"Build is failing\" \"Build is failing, error message: [paste error]. Fix it and verify the build succeeds. Address the root cause, don't just suppress the error\" Verification can be a test suite, linter, or Bash command that checks output. Invest time to make verification reliable. Provide Specific Context in Prompts Core Advice: The more precise your instructions, the fewer correctio"},{"id":"/cli/settings","title":"Settings Configuration","body":"Settings Configuration CodeBuddy Code uses a layered configuration system that enables personalization at different levels, from personal preferences to team standards to project specific requirements. Configuration Files The file is the official mechanism for configuring CodeBuddy Code, supporting layered settings: User settings are defined in and apply to all projects Project settings are stored in the project directory: for settings checked into source control and shared with the team for settings not checked in, suitable for personal preferences and experiments. CodeBuddy Code automatically configures git to ignore this file Complete Configuration Example Available Settings supports the following options: Key Description Example : : : Preferred response language. When set, CodeBuddy Code will respond in the specified language. Leave empty to auto detect based on user input Custom script executed in that generates an authentication value. This value is sent as both and headers for model requests Model ID used for text to image generation Model ID used for image to image generation How long to locally retain chat history based on last activity date (default: 30 days) Environment variables applied to every session Whether to include attribution in git commits and pull requests (default: ) Permission configuration, see table below Configure custom commands to run before and after tool execution. See Disable all Override the default model used by CodeBuddy Code Configure a custom status line to display context. See Auto approve all MCP servers defined in the project's file List of specific MCP servers approved from files List of specific MCP servers rejected from files Enable auto compaction Auto update settings Always enable thinking mode Whether to show the tokens counter in the interface Custom server endpoint address Environment routing mode configuration Bash sandbox configuration, see Enable prompt suggestions, automatically predicting next actions after the ag"},{"id":"/cli/models","title":"models.json Configuration Guide","body":"models.json Configuration Guide Overview is a configuration file used to customize the model list and control the model dropdown display. This configuration supports two levels: User level: Global configuration applicable to all projects Project level: Project specific configuration with higher priority than user level Configuration File Locations User level Configuration Project level Configuration Configuration Priority Configuration merge priority from highest to lowest: 1. Project level models.json 2. User level models.json 3. Built in default configuration Project level configuration will override user level configuration for the same model definitions (based on field matching). field: project level completely overrides user level, no merging. Configuration Structure Configuration Field Description models Type: Define custom model list. You can add new models or override built in model configurations. LanguageModel Fields Field Type Required Description string ✓ Model unique identifier string Model display name string Model vendor (e.g., OpenAI, Google) string API key, supports environment variable references (see Security Configuration below) number Maximum input tokens number Maximum output tokens string API endpoint URL, supports environment variable references (must be complete interface path, typically ending with ) number Sampling temperature, range 0 2, higher values produce more random output, lower values produce more deterministic output boolean Whether tool calls are supported boolean Whether image input is supported boolean Whether reasoning mode is supported Important Notes: Currently only supports OpenAI interface format API field must be the complete interface path, typically ending with Examples: or Security Configuration: Using Environment Variable References To avoid storing API keys in plain text in configuration files, the and fields support environment variable reference syntax . Syntax Format: Configuration Example: Setting Environment Var"},{"id":"/cli/memory","title":"Managing CodeBuddy's Memory","body":"Managing CodeBuddy's Memory Learn how to manage CodeBuddy Code's memory across sessions using different memory locations and best practices. CodeBuddy Code can remember your preferences across sessions, such as code style guides and common commands in your workflow. Determining Memory Types CodeBuddy Code provides four hierarchically structured memory locations, each serving a different purpose: Memory Type Location Purpose Example Use Cases Shared With User Memory Personal preferences across all projects Code style preferences, personal tool shortcuts Only you (across all projects) User Rules Modular personal rules Personal coding habits, common workflows Only you (across all projects) Project Memory or Team shared instructions for a project Project architecture, coding standards, common workflows Team members via source control Project Rules Modular, topic specific project instructions Language specific guidelines, testing specifications, API standards Team members via source control Project Memory (Local) Personal project specific preferences Your sandbox URL, preferred test data Only you (current project) All memory files are automatically loaded into CodeBuddy Code's context at startup. The loading order is as follows: 1. User level: Load main files like and all rules under 2. Project level main files: Recursively load all and from current working directory upward 3. Project level rules: Only load rules under in the current working directory (not parent directories) 4. Subdirectory memory: When CodeBuddy operates on files in subdirectories, dynamically load that subdirectory's 5. Local memory: Load Tip: CODEBUDDY.local.md files are automatically added to .gitignore, making them ideal for storing private project specific preferences that should not be committed to version control. CODEBUDDY.md Imports CODEBUDDY.md files can import additional files using the syntax. The following example imports 3 files: Both relative and absolute paths are supported. In particul"},{"id":"/cli/statusline","title":"Status Line Configuration","body":"Status Line Configuration Create a custom status line for CodeBuddy Code to display contextual information Personalize CodeBuddy Code with a custom status line that displays at the bottom of the CodeBuddy Code interface, similar to how terminal prompts (PS1) work in shells like Oh my zsh. Creating a Custom Status Line You can choose one of the following methods: Run to have CodeBuddy Code help you set up a custom status line. By default, it will try to replicate your terminal's prompt, but you can provide additional instructions about desired behavior, like Add a command directly to your : How It Works The status line updates when conversation messages are updated Updates run at most every 300ms The first line of stdout from the command becomes the status line text ANSI color codes are supported for styling the status line CodeBuddy Code passes context information about the current session (model, directory, etc.) to your script via stdin in JSON format JSON Input Structure Your status line command receives structured data in JSON format via stdin: Example Scripts Simple Status Line Git Aware Status Line Status Line with Colors Showing Cost and Statistics Python Example Node.js Example Helper Function Approach For more complex bash scripts, you can create helper functions: Complete Example Advanced Examples Showing Current Time and Session Duration Color Coded by Cost Tips Keep the status line concise it should fit on one line Use emoji (if your terminal supports them) and colors to make information easy to scan Use for JSON parsing in Bash (see examples above) Test your script by running it manually with mock JSON input: Consider caching expensive operations (like git status) if needed Ensure script output is valid UTF 8 for correct display of Chinese characters and emoji Common ANSI Color Codes Troubleshooting Status Line Not Showing Check if the script is executable: Ensure the script outputs to stdout (not stderr) Verify JSON paths are correct: Chinese Character"},{"id":"/cli/env-vars","title":"Environment Variables Reference","body":"Environment Variables Reference CodeBuddy Code supports environment variables to control its behavior. These variables can be set before startup, or configured in the field of to apply to every session. Tip: All environment variables can also be set in the field of , which automatically applies them to every session or rolls out configuration for an entire team. Authentication Environment Variable Description API key. Set this key for model API calls. Always uses this key in non interactive mode ( ) CodeBuddy platform authentication token for all platform API calls Custom HTTP headers. Format: , multiple headers separated by newline or API Endpoints and Proxy Environment Variable Description Override the API endpoint address, typically used with Network environment configuration ( for China edition, for iOA enterprise edition) / HTTP proxy server address / HTTPS proxy server address / List of domains and IPs to bypass proxy (comma separated, e.g., ) Model Configuration Environment Variable Description Override the default agent model Small, fast model used for background tasks Large model used for complex reasoning tasks Model used by sub agents Enable extended thinking and set the token budget for the thinking process. Disabled by default Bash Tool Configuration Environment Variable Description Default timeout for long running bash commands (default: 120000) Maximum characters of bash output retained in memory (default: 30000, max: 150000). Content exceeding the limit is mid truncated (keeping head 20% + tail 80%), and the full output is automatically saved to disk Maximum timeout the model can set for long running bash commands (default: 600000) Tool Output Externalization Environment Variable Description Size threshold (KB) for tool result externalization. Non bash tool results exceeding this threshold are saved to disk and replaced with a placeholder (default: 50) Note: Bash tool output externalization is controlled by . When output is truncated due to exceeding"},{"id":"/cli/terminal-config","title":"Optimize Your Terminal Setup","body":"Optimize Your Terminal Setup CodeBuddy Code works best when your terminal is properly configured. Follow these guidelines to optimize your experience. 🎨 Themes and Appearance CodeBuddy Code cannot control the theme of your terminal. That's handled by your terminal application. You can match CodeBuddy Code's theme to your terminal any time via the command. For additional customization of the CodeBuddy Code interface itself, you can configure a to display contextual information like the current model, working directory, or git branch at the bottom of your terminal. ⌨️ Line Breaks You have several options for entering line breaks into CodeBuddy Code: Ctrl+J: Cross platform shortcut, press Ctrl+J to insert a newline when entering multi line input Quick escape: Type followed by Enter to create a newline Shift+Enter: Automatically configured via the command (recommended) Set up Shift+Enter (Recommended): Run within CodeBuddy Code to automatically configure Shift+Enter. Supported terminals: macOS: iTerm2, Terminal.app IDE: VSCode, Cursor, Windsurf, Zed, CodeBuddy JetBrains: PyCharm, IntelliJ IDEA, WebStorm, PhpStorm, GoLand, Rider, CLion, RubyMine, AppCode, DataGrip Terminal Emulators: Ghostty, WezTerm, Kitty, Alacritty, Hyper, Tabby, Warp Windows: Windows Terminal Set up Option+Enter (VS Code, iTerm2 or macOS Terminal.app): For Mac Terminal.app: 1. Open Settings → Profiles → Keyboard 2. Check \"Use Option as Meta Key\" For iTerm2 and VS Code terminal: 1. Open Settings → Profiles → Keys 2. Under General, set Left/Right Option key to \"Esc+\" 🔔 Notification Setup Never miss when CodeBuddy completes a task with proper notification configuration: iTerm 2 System Notifications For iTerm 2 alerts when tasks complete: 1. Open iTerm 2 Preferences 2. Navigate to Profiles → Terminal 3. Enable \"Silence bell\" and Filter Alerts → \"Send escape sequence generated alerts\" 4. Set your preferred notification delay Note that these notifications are specific to iTerm 2 and not available in the "},{"id":"/cli/ide-integrations","title":"IDE Integration","body":"IDE Integration CodeBuddy Code supports two integration methods with editors, both at the same level of IDE integration capabilities: 1. Using the ACP (Agent Client Protocol) as a universal \"Agent Server\" called by IDEs 2. Using the startup parameter and slash command as an \"IDE plugin backend companion process\" for deep integration Integration Method 1: ACP Protocol Integration Suitable for editors that support ACP, such as Zed, using CodeBuddy Code as a universal Agent Server. Supported Editors Zed Editor Full integration via ACP protocol, supporting: Project context awareness Tool operation delegation (file read/write, terminal commands) Permission request interaction Real time streaming responses For configuration details, see: Integration Method 2: IDE Plugin Integration ( / ) Suitable for VS Code / Cursor / Windsurf / JetBrains series IDEs, integrated through plugin + local MCP server. The IDE side plugin is responsible for: Creating and maintaining MCP connections (SSE / WebSocket) Passing workspace information, selections, and other context to CodeBuddy via MCP protocol Exposing IDE capabilities like / / / for CodeBuddy to call Startup Parameter When you start CodeBuddy directly in the terminal, you can use the parameter to have the CLI actively try to connect to the IDE corresponding to the current working directory: Behavior description: CodeBuddy will scan lock files created by IDE plugins in the current user directory to detect available IDE instances Only considers an IDE as \"valid\" if its workspace contains the current directory Prioritizes connecting to IDEs whose \"workspace matches and process chain is upstream of the current terminal\" After successful connection, the CLI will obtain from the IDE MCP server: File/diff preview (openFile / openDiff) Diagnostic information (getDiagnostics) Selection change notifications (selectionchanged) is just a quick connection method when \"you manually start the CLI from an IDE terminal\" and is not responsible for "},{"id":"/cli/acp","title":"ACP Protocol Integration","body":"ACP Protocol Integration ACP (Agent Client Protocol) is a universal agent protocol introduced by the Zed editor that decouples the core functionality (server) from the user interface (client) of agents, allowing users to freely combine different agent servers and clients. CodeBuddy Code natively supports the ACP protocol and can seamlessly integrate as an agent server with ACP compatible editors. Quick Start Starting ACP Mode Use the parameter to start the CodeBuddy Code ACP server: Zed Editor Integration Configuration Steps Open the Zed configuration file ( ) and add the following configuration: You can then create a CodeBuddy Code Thread in the Zed sidebar and start using it. Configuration Details command: Specify the CodeBuddy Code command path (ensure is available in PATH) args: Use to enable ACP protocol mode env: Optional environment variable configuration, for example: Note: When using , you must correctly configure based on your version: International version: Do not set (default) China version: iOA version: See for details. ACP Protocol Features Authentication Information Extension CodeBuddy Code returns user information in the field of the response: Clients can use this information to provide a better user experience, such as displaying the currently logged in user or personalizing the interface. Tool Proxy Mechanism The ACP protocol supports client side proxying of certain tool operations, improving performance and security: File Operation Proxy: Based on the client's and capabilities Terminal Operation Proxy: Based on the client's capability When a client declares support for these capabilities, CodeBuddy Code will automatically proxy related tool calls to the client for execution. Command List Push CodeBuddy Code automatically pushes the available slash command list ( ) to the client when creating a new session, enabling the client to: Provide command auto completion functionality Display command hints and help information Dynamically update available c"},{"id":"/cli/gitlab-ci-cd","title":"CodeBuddy Code GitLab CI/CD Integration","body":"CodeBuddy Code GitLab CI/CD Integration Overview CodeBuddy Code supports deep integration with GitLab CI/CD, enabling you to leverage AI assistance for code review, automated implementation, and intelligent optimization tasks within your CI/CD pipelines. This integration is built on top of the CodeBuddy Code CLI, allowing you to programmatically use AI capabilities in GitLab CI jobs. How It Works CodeBuddy Code leverages GitLab CI/CD to run AI tasks in isolated jobs and submit results via MRs: 1. Event Driven Orchestration: GitLab listens for your chosen triggers (e.g., Issues, MRs, or @codebuddy mentions in comments). Jobs collect context and codebase information, build prompts, and run CodeBuddy Code. 2. Sandboxed Execution: Each interaction runs in a container with strict network and filesystem rules. CodeBuddy Code enforces workspace scoped permission constraints on writes. Every change flows through MRs, reviewers can see diffs, and approval workflows still apply. Configuration Guide Quick Setup The fastest way to get started is to add a minimal job to .gitlab ci.yml and set your API key as a protected variable. Step 1: Add Protected CI/CD Variables Go to your GitLab project's Settings → CI/CD → Variables and add the following environment variables: Authentication Configuration: Add the following environment variables in your GitLab project's Settings → CI/CD → Variables: CODEBUDDYAPIKEY (Required) API key for model interface calls When configuring, check: ✅ Protect variable, ✅ Mask variable Optional Configuration: CODEBUDDYINTERNETENVIRONMENT Network environment configuration (China version users need to set to , iOA users set to ) CODEBUDDYBASEURL Custom base URL for model service (must be compatible with OpenAI API protocol) GITLABACCESSTOKEN GitLab project access token (requires api scope) Used for CodeBuddy to create/update MRs and comments If not configured, defaults to using When configuring, check: ✅ Protect variable, ✅ Mask variable 📖 Complete Configu"},{"id":"/cli/devcontainer","title":"CodeBuddy Code Dev Container","body":"CodeBuddy Code Dev Container CodeBuddy Code Dev Container provides a pre configured, secure development environment suitable for teams that need consistent and isolated workspaces. It seamlessly integrates with Visual Studio Code's Dev Containers extension and similar tools. Quick Start in Four Steps 1. Install VS Code and the Remote Containers extension 2. Create the directory and related files in your workspace following the configuration details below 3. Open the repository in VS Code 4. When prompted, click \"Reopen in Container\" (or use Command Palette: Cmd+Shift+P → \"Remote Containers: Reopen in Container\") 🚀 Installing CodeBuddy Code (Recommended Approach) Option 1: Using Dev Containers Feature (Recommended) Dev Containers Feature is the recommended way to install CodeBuddy Code in a Dev Container. It provides automatic version management, configuration consistency with other features, simplified maintenance, and more. Advantages: ✅ Automatic version management Easily upgrade to the latest version or pin to a specific version ✅ Configuration consistency Uses the same configuration approach as other Dev Containers features ✅ Simplified maintenance No need to manage complex installation logic in Dockerfile ✅ Team sharing Easy to standardize configuration across teams Configuration Method: Add configuration to the field in : Pin to Specific Version: Use Default Latest Version: Option 2: Manual Installation in Dockerfile If you need more control or have special scenarios, you can manually install in the Dockerfile. See the Dockerfile section below for details. 1. devcontainer.json Controls container settings, manages extensions, and configures volume mounts. Complete Example with Dev Containers Feature: Key Configuration Notes: Declares the use of CodeBuddy Code Dev Containers Feature, supports version management Uses the latest version (can be replaced with a specific version like \"2.16.0\") Note: When using the Feature approach, no parameter is needed in the Doc"},{"id":"/cli/mcp","title":"MCP (Model Context Protocol) Usage Documentation","body":"MCP (Model Context Protocol) Usage Documentation Overview MCP (Model Context Protocol) is an open standard that allows CodeBuddy to integrate with external tools and data sources. Through MCP, you can extend CodeBuddy's functionality by connecting to various external services, databases, APIs, and more. Core Concepts MCP Server An MCP server is an independent process that provides tools, resources, and prompts. CodeBuddy communicates with these servers through different transport protocols. MCP Prompts Integration MCP servers can provide Prompts (prompt templates), which are automatically converted into CodeBuddy's slash commands. When an MCP server is connected: Prompts provided by the server are automatically registered as slash commands Command name format: Supports dynamic parameters, collecting user input through an interactive interface Command execution calls the MCP server's interface to retrieve complete content Supports real time monitoring of configuration changes, automatically updating the list of available commands Transport Types STDIO: Communication with local processes via standard input/output SSE: Communication with remote services via Server Sent Events HTTP: Communication with remote services via HTTP streaming Configuration Scope user: Global user configuration, applied to all projects project: Project level configuration, applied to specific projects local: Local configuration, applied only to the current session or workspace For services with the same name (i.e., configurations with the same name across multiple scopes), the effective priority is: Security Approval Mechanism MCP servers in the project scope require user approval upon first connection to ensure security. The system displays detailed server information, and users can choose to approve or deny the connection. Approval in Non Interactive Mode ( p/ print) In non interactive mode (such as when using the parameter), since approval cannot be done through the UI, you need to pre confi"},{"id":"/cli/slash-commands","title":"CodeBuddy Code Slash Commands","body":"CodeBuddy Code Slash Commands CodeBuddy Code supports slash commands, allowing you to perform special operations, manage sessions, and customize common workflows within your chat. Built in Slash Commands These commands are used to manage your CodeBuddy Code sessions. Here is the current support status: Command Parameters CodeBuddy Support Description : : ✅ Supported Display help information and provide guidance on feedback channels. ✅ Supported Start a new conversation (old conversations can be restored via ). ✅ Supported Log in to your account. ✅ Supported Log out of your current account. ✅ Supported Check the status and environment of CodeBuddy Code. ✅ Supported Display the status of the current repository and session. ✅ Supported Add a working directory. Specify the path of the directory to add. ✅ Supported Manage experimental AI agents ✅ Supported Quick side question without interrupting the current Agent workflow. Useful for asking brief questions while the Agent is executing a task. Answers are generated based on existing context. ✅ Supported Compress context. ✅ Supported View or modify local configuration. Opens an interactive panel when used without parameters, lists current settings, reads a setting, modifies a setting. ✅ Supported Calculate the context token distribution for the current session. ✅ Supported Display session cost and token usage. ✅ Supported Initialize a new CodeBuddy repository. ✅ Supported Manage MCP connections. ✅ Supported Manage long term memory ✅ Supported Switch or view the currently used AI model. Opens an interactive selection interface when used without parameters, lists available models, or directly switches to the specified model when provided with a model name (e.g., ). ✅ Supported Switch or view the currently used text to image model. Opens an interactive selection interface when used without parameters, lists available models, or directly switches to the specified model when provided with a model ID. ✅ Supported Switch or view"},{"id":"/cli/sub-agents","title":"Sub-Agents","body":"Sub Agents Create and use specialized AI sub agents in CodeBuddy Code for specific task workflows and improved context management. Custom sub agents in CodeBuddy Code are specialized AI assistants that can be invoked to handle specific types of tasks. They enable more efficient problem solving by providing task specific configurations with custom system prompts, tools, and independent context windows. What are Sub Agents? Sub agents are pre configured AI personas that CodeBuddy Code can delegate tasks to. Each sub agent: Has a specific purpose and area of expertise Uses its own context window, separate from the main conversation Can be configured to allow specific tool usage Contains a custom system prompt that guides its behavior When CodeBuddy Code encounters a task that matches a sub agent's area of expertise, it can delegate that task to the specialized sub agent, which works independently and returns results. Key Benefits Benefit Description : : Context Preservation Each sub agent runs in its own context, preventing pollution of the main conversation and keeping it focused on high level goals. Specialized Expertise Sub agents can be fine tuned with domain specific detailed instructions, improving success rates for designated tasks. Reusability Once created, sub agents can be used across different projects and shared with your team for consistent workflows. Flexible Permissions Each sub agent can have different tool access levels, allowing you to restrict powerful tools to specific sub agent types. Quick Start To create your first sub agent: 1. Open Sub Agent Interface Run the following command: 2. Select \"Create New Agent\" Choose whether to create a project level or user level sub agent 3. Define Sub Agent Recommended: Start with AI generation, then customize to make it your own Describe your sub agent and when it should be used in detail Select the tools you want to grant access to, or leave empty to inherit all tools The interface shows all available tools If"},{"id":"/cli/agent-teams","title":"Agent Teams: Multi-Agent Collaboration","body":"Agent Teams: Multi Agent Collaboration Agent Teams lets you coordinate multiple CodeBuddy Code instances into a team, completing complex tasks through shared task lists, inter member messaging, and centralized management. This feature currently has . Agent Teams lets you coordinate multiple CodeBuddy Code instances working together. One session serves as the team lead, responsible for coordinating work, assigning tasks, and aggregating results; the remaining members (teammates) work independently, each with their own context window, and communicate directly with each other through a messaging system. Unlike , where sub agents run within a single session and can only report results back to the main agent, Agent Teams members can communicate directly with each other, and you can bypass the lead to talk to any member directly. When to Use Agent Teams Agent Teams is most effective for tasks where parallel exploration creates real value. Typical scenarios include: Research and Review: Multiple members investigate different aspects of a problem simultaneously, then share and challenge each other's findings New Module Development: Each member is responsible for an independent module without interfering with each other Competitive Hypothesis Debugging: Members test different hypotheses in parallel, converging on the correct answer faster Cross layer Coordination: Frontend, backend, and testing are each handled by different members, progressing in sync Agent Teams introduces additional coordination overhead, and token consumption is significantly higher than single session. It works best when members can work independently. For sequential tasks, same file edits, or work with complex dependencies, single session or sub agents are more appropriate. Comparison with Sub agents Sub agents Agent Teams : : : Context Independent context window, results returned to caller Independent context window, fully independent Communication Can only report results to the main agent Members can"},{"id":"/cli/skills","title":"CodeBuddy Code Skills (Skills System)","body":"CodeBuddy Code Skills (Skills System) Skills are CodeBuddy Code's extension capability system that allows you to create specialized domain knowledge and workflow templates, enabling the AI assistant to handle specific types of tasks with greater expertise. What are Skills Skills are like \"professional training\" for the AI assistant. With Skills, you can: Encapsulate specialized knowledge: Package domain specific best practices and operational procedures into reusable capabilities Provide workflow templates: Define standardized task processing flows to improve work efficiency Extend AI capabilities: Enable the AI assistant to handle more specialized and complex tasks Share team collaboration: Project level Skills allow teams to share specialized knowledge among members Skills vs Slash Commands Feature Skills Slash Commands Invocation Automatically identified and invoked by the AI model Manually entered by the user Use Case Specialized domain task processing Quick operations and workflows Permission Control Supports tool allowlist restrictions No special permission control Working Directory Supports custom base directory Uses current working directory Visibility Transparent to user, AI makes decisions automatically Actively initiated by user In simple terms: Slash Commands are shortcuts actively invoked by users Skills are specialized capabilities automatically selected by the AI based on task requirements Creating Skills Directory Structure Skills are defined by creating a file in specific directories: 1. Project level Skills: (in project root) 2. User level Skills: (in user home directory) Each Skill has its own directory containing a file: SKILL.md Format Skill files use Markdown format and support YAML Frontmatter for defining metadata: Frontmatter Fields Field Required Description Example No Skill name, uses directory name if not specified No Skill description, helps AI understand when to use it No Allowlist of permitted tools, comma separated No When set to , th"},{"id":"/cli/hooks-guide","title":"Hooks Guide","body":"Hooks Guide Learn how to customize and extend CodeBuddy Code's behavior by registering shell commands We recommend reading the first to understand all events, input/output structures, and security requirements. This guide focuses on practical walkthroughs and common examples to help you quickly enable Hooks functionality in your CodeBuddy Code projects. Note: The Hooks feature is currently in Beta and is being actively refined. Please watch for updates in future releases. Now you've mastered the core workflow for enabling hooks in CodeBuddy Code. For more details on event fields, decision control, and security considerations, check out the . Happy building powerful and secure automated workflows!"},{"id":"/cli/plugins","title":"CodeBuddy Plugin System","body":"CodeBuddy Plugin System CodeBuddy Code supports a powerful plugin system that allows you to extend and customize the CLI's functionality. Through plugins, you can add new commands, skills, and hooks, creating a personalized development environment that fits your workflow. Core Concepts What is a Plugin? A plugin is a reusable functionality package that can contain the following components: Commands: Slash commands that users can manually trigger Skills: Specialized capabilities that the AI automatically recognizes and invokes Hooks: Operations that automatically execute when specific events are triggered What is a Plugin Marketplace? A plugin marketplace is a publishing and distribution channel for plugins. CodeBuddy supports multiple types of plugin marketplaces: Local Directory Marketplace: Load plugins from the local filesystem GitHub Repository Marketplace: Fetch plugins from GitHub repositories HTTP/HTTPS Marketplace: Fetch plugin manifests and packages from HTTP(S) servers Quick Start There are three ways to manage plugins: Team Configuration Auto Installation, Interactive Interface, and Command Line Subcommands. Method 1: Team Configuration Auto Installation (Recommended) Teams can configure and in the project's to enable automatic plugin installation and activation. When team members start CodeBuddy, the system automatically installs the plugin marketplaces and plugins specified in the configuration. Configuration Example Add the following configuration to : Configuration Explanation : Define additional plugin marketplaces Key is the marketplace name (e.g., ) : Marketplace type, supports , , and : GitHub repository path (format: , only when source is ) : Git repository URL or HTTP(S) marketplace.json URL (only when source is or ) : Specify plugins to enable Key format: Value means enabled, means disabled Automatic Installation Flow 1. Startup Detection: CodeBuddy automatically detects the configuration file on startup 2. Marketplace Installation: Automatical"},{"id":"/cli/plugin-marketplaces","title":"Plugin Marketplaces","body":"Plugin Marketplaces A plugin marketplace is a plugin directory file used to distribute and manage CodeBuddy extensions. It is a JSON formatted configuration file that lists available plugins and their source information. Core Features Centralized Discovery: Browse plugins from multiple sources in one place Version Management: Automatically track and update plugin versions Auto Update: Support enabling auto update to periodically sync marketplace content Team Distribution: Share required plugins within organizations Flexible Sources: Support for Git repositories, GitHub repositories, local paths, and HTTP URLs Using Plugin Marketplaces Prerequisites CodeBuddy installed and running Basic understanding of JSON file format For creating a marketplace: Git repository or local development environment Adding a Plugin Marketplace 1. Add a GitHub Marketplace The repository must contain a file. 2. Add a Git Repository Marketplace 3. Add a Local Marketplace (for development) 4. Add an HTTP Marketplace Installing Plugins from a Marketplace Verifying Marketplace Installation 1. List Marketplaces: Run to confirm the marketplace was added 2. Browse Plugins: Use to view available plugins in the marketplace 3. Test Installation: Try installing a plugin to verify the marketplace is working properly Team Configuration Automatically Install Team Marketplaces Configure in : When team members start CodeBuddy, the system automatically installs these marketplaces and the plugins specified in the field. Automatic Installation Flow 1. Startup Detection: CodeBuddy automatically detects the configuration file on startup 2. Marketplace Installation: Automatically installs marketplaces from that are not yet installed 3. Plugin Installation: Automatically installs enabled plugins from that are not yet installed 4. Background Execution: The installation process executes asynchronously in the background without blocking the startup flow 5. Logging: The installation process logs detailed information,"},{"id":"/cli/checkpointing","title":"Checkpointing (Beta)","body":"Checkpointing (Beta) ⚠️ Beta Feature: Checkpointing is currently in Beta and features may change. Overview Automatically track and rewind CodeBuddy edits to quickly restore unwanted changes. CodeBuddy Code automatically tracks CodeBuddy's edits to files as you work, allowing you to quickly undo changes and revert to a previous state if something goes wrong. Common Use Cases Checkpointing is particularly useful in these scenarios: Exploring Alternatives: Try different implementation approaches without losing your starting point Recovering from Errors: Quickly undo changes that introduced bugs or broke functionality Feature Iteration: Confidently experiment knowing you can always restore to a working state See Also Keyboard shortcuts and session control Use to access checkpoints"},{"id":"/cli/worktree","title":"Git Worktree Support","body":"Git Worktree Support Run CodeBuddy in isolated workspaces for parallel development and safe isolation. Overview Git worktree allows you to have multiple working directories simultaneously within the same repository, each checked out to a different branch. CodeBuddy Code leverages this feature to provide: Parallel development: Perform experimental development without affecting the main workspace Safe isolation: All AI changes are made in a separate directory Zero storage overhead: Worktrees share Git objects without duplicating the entire repository Sub agent isolation: Multiple AI sub agents can work in parallel in independent worktrees tmux integration: Optionally run in a dedicated tmux session Non Git support: SVN, Perforce, and other projects can also use worktree isolation via WorktreeCreate/WorktreeRemove hooks Quick Start Creating Within a Session After starting a CodeBuddy Code session, you can create a worktree via natural language: The AI will automatically invoke the tool to create an isolated working directory and switch to it. Note: This is only triggered when \"worktree\" is explicitly mentioned. Saying \"create a branch for me\" or \"fix this bug\" will not automatically create a worktree. CLI Parameters Parameter Description Example : : : Create and enter a worktree or Specify the base branch (requires ) or Run in a tmux session (requires tmux installed) Use classic tmux mode (without popup) Workflow Creating a Worktree When starting with the parameter: 1. CodeBuddy creates a new worktree under the directory 2. Determines the base branch: If is specified, uses the remote branch If is specified, uses the local branch If not specified, defaults to the remote default branch (usually or ) 3. Automatically creates a corresponding branch (e.g., ) 4. Switches the working directory to the worktree 5. Runs initialization (copies settings, creates symlinks, copies files, etc.) Behavior when the branch does not exist: If the specified branch (remote or local) does no"},{"id":"/cli/remote-control","title":"Remote Control","body":"Remote Control Beta: The Remote Control feature is currently in Beta. Functionality and interfaces may change in future releases. Feel free to try it out and share your feedback. With Remote Control, you can access a locally running CodeBuddy Code session from your phone, tablet, or any browser. The session always runs on your local machine — the Web UI is simply a remote window. Overview Remote Control starts a Gateway service locally and exposes a Web UI through a Cloudflare Tunnel or LAN, allowing you to connect to a running CodeBuddy Code session from any device. With Remote Control, you can: Use your full local environment remotely: File system, MCP servers, and tool configurations all remain available Interact with the Agent via Web UI: Send messages, view conversations, and monitor tool execution in the browser Connect from multiple devices: Scan a QR code from your phone to connect, with both LAN and public network access supported Manage sessions from the terminal: Work simultaneously in the terminal and the Web UI, with conversations kept in sync Prerequisites CodeBuddy Code installed and logged in (run and use to log in) For public network access, install (optional) Starting Remote Control Use the command in a CodeBuddy Code session to start the Remote Control service: Once started successfully, the terminal displays connection information: Connection Methods After the Gateway starts, you can connect from other devices in the following ways: Scan the QR code: Scan the QR code displayed in the terminal with your phone to open the Web UI directly Copy the Web UI link: Open the URL with the authentication token in any browser LAN access: Devices on the same network can access the Local address directly (e.g., ) Subcommands Command Description : : Start the Gateway (with Tunnel by default) View the current Gateway status Stop the Gateway Regenerate the authentication token Start the Gateway with Tunnel Network Modes The Gateway supports two network modes to a"},{"id":"/cli/web-ui","title":"Web UI","body":"Web UI CodeBuddy Code provides a built in Web UI that offers a full featured browser interface for interacting with the Agent. When you start CodeBuddy Code in serve mode or enable Remote Control, the Web UI is automatically available. Overview The Web UI provides the same core capabilities as the terminal interface, with a visual layout optimized for browsers: Chat: Send messages, view conversations, and monitor tool execution in real time Terminal: Embedded terminal with split pane support (up to 4 panels) Workers: Manage CLI Worker processes and the Daemon process Logs: Dedicated log viewer with support for multiple log types and keyword search Remote Control: Connect WeChat and WeCom channels Monitoring: System resource metrics and per Worker process level memory/uptime metrics Tasks: Browse task templates and create scheduled tasks Plugins: Manage plugin installations and plugin marketplace Settings: Configure theme, language, model, and permission mode Documentation: Browse CLI documentation with full text search API Reference: View the interactive Swagger UI for HTTP API exploration Accessing the Web UI Method 1: Serve Mode Start CodeBuddy Code with the flag: Then open in your browser: Method 2: Remote Control In an existing CodeBuddy Code session, start the Gateway: The terminal displays a QR code and URL. Scan the QR code with your phone or open the URL in any browser. See the documentation for details. Authentication The Web UI supports two authentication modes: Mode Setting Description : : : No Auth (default) No password required Password Password shown in terminal on startup Authentication methods (any one is sufficient): URL parameter: — auto login via URL Login page: Enter the password displayed in the terminal Bearer token: for API access Configure in : Features Chat View The default view for conversing with the Agent. Key features: Rich message rendering: Markdown, syntax highlighted code blocks, tables, and images Tool execution display: See tool ca"},{"id":"/cli/scheduled-tasks","title":"Scheduled Tasks","body":"Scheduled Tasks CodeBuddy Code supports creating and managing scheduled tasks within a session. You can set up tasks that execute instructions on a recurring schedule or trigger a one time action at a specific future time. Common use cases include: periodically checking build status, polling for task completion, setting reminders at specific times, and more. Note: Scheduled tasks are session scoped. Tasks are only active while CodeBuddy Code is running and are automatically cleared upon exit. Creating One Time Reminders If you only need a reminder at a specific future time, you can describe it in natural language: These tasks trigger once at the specified time and are automatically deleted after execution. Task Execution Mechanism Execution Timing Tasks only trigger when the session is idle — that is, when the system is not processing other requests. If an operation is in progress when the task is due, the trigger is deferred until the operation completes. Time Jitter The system adds a small random offset to task trigger times to prevent congestion from many tasks firing simultaneously: Recurring tasks: Delayed by up to 10% of the cycle duration (capped at 15 minutes) One time tasks: For tasks set to the hour or half hour, may trigger up to 90 seconds early For example, a task set to run may actually trigger randomly within 0–6 minutes after the hour. Auto Expiration Recurring tasks automatically expire and are deleted after 3 days, with one final trigger before expiration. If you need tasks to persist longer, you can recreate them after expiration or use an external scheduling solution (such as GitHub Actions). Cron Expression Reference For precise schedules like \"every Monday at 10 AM\" or \"the 1st of every month,\" simply describe your requirement to the AI, and it will automatically convert it to a cron expression and create the task: The AI response will include the actual cron expression and execution frequency used, so you can confirm whether it matches your ex"},{"id":"/cli/wecom-bot-setup","title":"WeChat Work AI Bot Integration Guide","body":"WeChat Work AI Bot Integration Guide Through the command, you can quickly integrate CodeBuddy Code with WeChat Work AI Bot, enabling remote message driven functionality. Using WebSocket long polling active connection mode, no public IP is required, making configuration the simplest option. Prerequisites Registered WeChat Work account CodeBuddy Code installed: Completed login authentication: After running , execute 2. Configure Environment Variables Before starting CodeBuddy CLI, set the following environment variables: Optional Configuration Environment Variable Description Default Value AI Bot ID (required) — AI Bot Secret (required) — WebSocket server address (used for private deployment) Persistent Configuration (Optional) Add environment variables to your shell startup file for automatic loading on each startup: 4. Panel Operation Instructions Operation Description / Select client entry / Vim style navigation (equivalent to up/down arrow keys) Connect (in state) or disconnect (in / state) Exit panel (not responsive during operations in progress) 5. Verify Integration After establishing the connection, you can verify that the Bot is working properly through the following methods. Method 1: Direct Conversation 1. Open the WeChat Work client (desktop or mobile) 2. Find the Bot you created in the message list 3. Send a test message (such as \"Hello\") and confirm the Bot replies Method 2: Group Chat 1. Add the Bot to a group chat 2. Send a message via @Bot name in the group 3. The Bot will respond to @mentioned messages 6. Message Processing Flow and Status Indicators Complete Message Processing Flow The processing flow after a user sends a message to the Bot: Streaming Status Indicator Mechanism Utilizing the full replacement feature of WeChat Work streaming messages ( stream type): 1. Immediate Reply: After receiving a user message, immediately send a streaming message with , content: \"Processing, please wait...\" 2. In place Replacement: After the Agent finishes pro"},{"id":"/cli/channels","title":"Channels: Push External Events into Sessions [Beta]","body":"Channels: Push External Events into Sessions [Beta] Beta Feature: Channels is currently in Beta. Features and interfaces may be adjusted based on feedback. A Channel is an MCP server that pushes messages, alerts, and webhooks into your running CodeBuddy Code session, allowing CodeBuddy Code to react to external events even when you're not at the terminal. Channels can be two way: CodeBuddy Code reads events and replies through the same channel, acting like a chat bridge. Events only arrive while a session is open; for continuous operation, run CodeBuddy Code in a background process or persistent terminal. You can enable channels by installing plugins or using built in channels. WeChat, Telegram, Discord, and the fakechat demo are all supported. When CodeBuddy Code replies through a channel, the terminal shows the tool call and confirmation (e.g., \"sent\"), while the actual reply content appears on the corresponding chat platform. This page covers: : WeChat, Telegram, Discord, and fakechat setup : Quick hands on experience with the WeChat channel : Sender allowlists and pairing flows : Enabling channels for teams and enterprises To build your own channel, see the . Supported Channels WeChat (Built in) The WeChat channel is built into CodeBuddy Code and requires no plugin installation. It enables two way messaging through WeChat ClawBot, supporting text, images, and file exchange. Prerequisites: WeChat version iOS 8.0.70 or above Enable the ClawBot plugin in WeChat (WeChat Me Settings Plugins ClawBot) QR Code Binding: 1. In CodeBuddy Code, run or and select wechat 2. The terminal displays a QR code (if the QR code doesn't render correctly, a browser link will be provided) 3. Scan the QR code with WeChat and confirm 4. After successful binding, message reception starts automatically Usage: After binding, send messages in the WeChat ClawBot conversation, and they will automatically appear in the CodeBuddy Code session: CodeBuddy Code processes the message and replies via"},{"id":"/cli/daemon","title":"Daemon Mode and Background Sessions","body":"Daemon Mode and Background Sessions Daemon mode runs CodeBuddy Code as a background resident service, independent of any terminal window. Once started, it provides a full HTTP API and Web UI, ready to accept requests at any time. Core value: Transform the CLI from \"use and go\" to \"always on standby\". Concepts Concept Description Worker A running CLI process, registered via a PID file in Daemon A background resident HTTP service process ( mode), managed via Background Session (bg) A non interactive task started with , with output automatically logged to a file Daemon Management Starting the Daemon Once started, the daemon runs as a detached process and the parent process exits immediately. Local addresses have password free access by default; non local addresses automatically enable password authentication. Idempotent startup: Running multiple times does not create multiple daemons. If a daemon is already running, it returns the existing daemon's information. Checking Status Stopping / Restarting Background Sessions Starting Background Tasks Background sessions run in mode (no TUI + skip permission confirmations), with stdout/stderr redirected to . Process Management Commands HTTP API All Worker and Daemon management capabilities are exposed via REST APIs. The Web UI Workers page is built on top of these APIs. See the Workers & Daemon section in the for details. Examples Web UI After starting in mode, the Web UI provides three management pages: Workers — Worker process management and Daemon control Logs — Standalone log viewer with Worker selection, log type switching, and keyword search Metrics — System resource monitoring and per Worker process level metrics Log System The log API supports 4 types, with automatic priority based selection: Type Path Content Trigger Info/Warn/Error from all modules Always (default priority) Process stdout/stderr bg/daemon only Detailed debug information Requires Conversation history Always PID File Registry Each CLI process registers"},{"id":"/cli/security","title":"Security","body":"Security Learn about CodeBuddy Code's security protections and best practices for secure usage. Security Approach Security Foundation Your code security is paramount. CodeBuddy Code is built with security as a core principle, developed following Tencent's comprehensive security program. Permission Based Architecture CodeBuddy Code uses strict read only permissions by default. When additional operations are needed (editing files, running tests, executing commands), CodeBuddy Code requests explicit permission. Users control whether to approve operations once or allow automatically. We designed CodeBuddy Code to be transparent and secure. For example, we require approval before executing bash commands, giving you direct control. This approach enables users and organizations to configure permissions directly. For detailed permission configuration, see . Built in Protections To mitigate risks in agentic systems: Sandboxed bash tool: isolates bash commands' file system and network access, reducing permission prompts while maintaining security. Enable with to define boundaries within which CodeBuddy Code can work autonomously Write Access Restrictions: CodeBuddy Code can only write to the folder where it was launched and its subfolders—cannot modify files in parent directories without explicit permission. While CodeBuddy Code can read files outside the working directory (useful for accessing system libraries and dependencies), write operations are strictly limited to project scope, creating a clear security boundary Prompt Fatigue Mitigation: Support for whitelisting frequently used safe commands per user, per codebase, or per organization Accept Edits Mode: Batch accept multiple edits while maintaining permission prompts for commands with side effects User Responsibility CodeBuddy Code only has the permissions you grant it. You are responsible for reviewing the security of suggested code and commands before approval. Prompt Injection Protection Prompt injection is an atta"},{"id":"/cli/iam","title":"Identity and Access Management","body":"Identity and Access Management Learn how to configure user authentication, authorization, and access control for CodeBuddy Code in your organization. Authentication Methods Quick Start Choose an authentication method based on your scenario: Scenario Recommended Method How to Get Credentials : : : Individual Developer Enterprise/Team (OAuth Integration) CI/CD with existing OAuth token Use existing token directly Third party Model Service + Get from third party provider When multiple authentication methods are configured, they take effect in the following priority: CODEBUDDYAUTHTOKEN apiKeyHelper CODEBUDDYAPIKEY Enterprise Users: OAuth Authentication Suitable for enterprise/team integration, obtaining tokens via OAuth 2.0. Currently only introducing the Client Credentials authorization method, suitable for server side applications and CI/CD scenarios. Prerequisite: Enterprise users need to purchase CodeBuddy Premium before using OAuth authentication. See the for details. Step 1: Create Application, Get Client ID and Secret Refer to the to complete: 1. Create an enterprise application 2. Get Client ID and Client Secret Step 2: Create a Script to Get Token Step 3: Configure apiKeyHelper Configure in or project : After configuration, you can use the command. Tokens obtained by apiKeyHelper are cached for 5 minutes by default. You can adjust this via the environment variable (in milliseconds). Authentication Methods Explained CODEBUDDYAPIKEY Static API Key, suitable for most scenarios. Feature Description : : Environment Variable Auth Type API Key (X Api Key header) Use Cases Personal development, third party model services Warning: When using API Key, you must also configure the environment variable! Version Configuration Value : : International Not set (default) China iOA CODEBUDDYAUTHTOKEN Pre obtained OAuth Bearer Token, suitable for CI/CD or scenarios with existing tokens. Feature Description : : Environment Variable Auth Type Bearer Token (Authorization header) Use "},{"id":"/cli/bash-sandboxing","title":"Bash Sandbox","body":"Bash Sandbox Learn how CodeBuddy Code's sandboxed Bash tool provides file system and network isolation for safer, more autonomous agent execution. Overview CodeBuddy Code features native sandbox capabilities that provide a more secure environment for agent execution while reducing constant permission prompts. Instead of requiring permission for every bash command, the sandbox creates predefined boundaries that allow CodeBuddy Code to work more freely with reduced risk. The sandboxed Bash tool uses operating system level primitives to enforce file system and network isolation. Why Sandbox Matters Traditional permission based security requires continuous user approval for bash command execution. While this provides control, it can lead to: Approval Fatigue: Repeatedly clicking \"approve\" may cause users to pay less attention to what they're approving Reduced Productivity: Constant interruptions slow down development workflows Limited Autonomy: CodeBuddy Code cannot work efficiently while waiting for approvals Sandbox addresses these challenges by: 1. Defining Clear Boundaries: Explicitly specifying which directories and network hosts CodeBuddy Code can access 2. Reducing Permission Prompts: Safe commands within the sandbox don't require approval 3. Maintaining Security: Attempts to access resources outside the sandbox trigger immediate notifications 4. Enabling Autonomy: CodeBuddy Code can run more independently within defined limits <Warning Effective sandboxing requires both file system and network isolation. Without network isolation, a compromised agent could exfiltrate sensitive files (like SSH keys). Without file system isolation, a compromised agent could backdoor system resources to gain network access. When configuring sandbox, it's important to ensure your configuration settings don't create bypasses in these systems. </Warning How It Works File System Isolation The sandboxed Bash tool restricts file system access to specific directories: Default Write Behavi"},{"id":"/cli/cli-reference","title":"CLI Reference","body":"CLI Reference Complete reference manual for the CodeBuddy Code command line tool, including all commands and parameter descriptions. CLI Commands Command Description Example : : : Start interactive REPL Start REPL with initial prompt Query via SDK and exit Process piped content Continue the most recent conversation Continue conversation via SDK Resume session by ID Update to the latest version Configure Model Context Protocol (MCP) servers See Start the Daemon process Stop the Daemon View Daemon status Restart the Daemon List all active Worker processes View Worker logs Attach to a background Worker Terminate a Worker process CLI Parameters Command line parameters to customize CodeBuddy Code behavior: Parameter Description Example : : : Add additional working directories for CodeBuddy to access (validates each path for existence) Dynamically define custom via JSON (format described below) List of tools allowed without prompting the user, in addition to List of tools to disallow, in addition to Restrict available built in tool set (whitelist). Empty string disables all built in tools, uses all tools, or specify comma separated tool names , Print response and exit without entering interactive mode Load additional settings configuration from a JSON file or JSON string Specify which settings sources to load, comma separated (options: , , ). Default: Replace the entire system prompt with custom text (available in both interactive and print modes) Load system prompt from file, replacing the default (print mode only) Append custom text to the end of the default system prompt (available in both interactive and print modes) Specify output format for print mode (options: , , ) Specify input format for print mode (options: , ) Validate structured output with JSON Schema. Example: Include partial streaming events in output (requires and ) Enable verbose logging, showing complete turn output (helpful for debugging in both print and interactive modes) Limit the number of agent tu"},{"id":"/cli/hooks","title":"Hooks Reference","body":"Hooks Reference Version requirement: This guide targets the Claude Code Hooks–compatible implementation shipped with CodeBuddy Code v1.16.0 and later. Feature status: Hooks are currently in Beta; APIs and runtime behavior may evolve. Hooks let you inject custom scripts or commands into every stage of a CodeBuddy Code session so you can automate validation, bootstrap environments, run compliance checks, and more. Our implementation is fully compatible with the Claude Code Hooks specification, including event names, payload schemas, and safety guarantees. Configuration CodeBuddy Code stores hook configuration inside your settings files: Scope Path Notes User Applies to every project Project Shared with the whole repo Project local Local only overrides (not committed) Enterprise policy Distributed policy bundle Managed centrally by your org Merge behavior: Hooks from different scopes are merged, not overwritten. All matching hooks for the same event run in parallel. Structure Hooks are grouped by matcher, and each matcher may contain multiple hook definitions: Key fields: matcher – Regex pattern for tool names, case sensitive (only for and ). Simple string match: matches any tool name containing \"Write\" (e.g., , ). Exact match: Use to match only the Write tool. Multiple tools: or . Match all tools: Any of the following are equivalent: Use Use empty string Omit the field hooks – Array executed when the matcher hits. type – Execution mode. Use for shell commands, or for LLM based evaluation. command – (type = ) Shell command to run. is available. Executed using the user's default shell ( ) on macOS/Linux, and Git Bash is enforced on Windows (cmd.exe and PowerShell are not supported), so commands must be compatible with bash syntax. prompt – (type = ) Prompt text sent to the LLM for evaluation (only supports , , and events). timeout – Optional timeout in seconds for the specific hook. For events that do not use matchers ( , , , etc.) you can omit the field entirely: Proje"},{"id":"/cli/plugins-reference","title":"CodeBuddy Plugin Reference","body":"CodeBuddy Plugin Reference Overview The CodeBuddy plugin system allows you to extend the AI assistant's functionality through a standardized plugin mechanism. Plugins can provide custom commands, agents, skills, hooks, MCP servers, and LSP servers. description: Command description allowed tools: Read,Write,Bash argument hint: Argument hint model: Model ID or name to use name: Agent name (optional, defaults to filename) description: Agent description model: Model ID or name to use tools: Read,Write,Bash (comma separated list of available tools) color: #FF5733 (agent display color, optional) Agent instruction content skills/ ├── pdf processor/ │ ├── SKILL.md │ ├── reference.md (optional) │ └── scripts/ (optional) └── code reviewer/ └── SKILL.md markdown name: Skill name (optional, defaults to directory name) description: Skill description allowed tools: Read,Write,Bash (list of allowed tools) Skill instruction content json { \"PostToolUse\": [ { \"matcher\": \"Write Edit\", \"hooks\": [ { \"type\": \"command\", \"command\": \"${CODEBUDDYPLUGINROOT}/scripts/format code.sh\", \"timeout\": 30000 } ] } ] } json { \"mcpServers\": { \"plugin database\": { \"command\": \"${CODEBUDDYPLUGINROOT}/servers/db server\", \"args\": [\" config\", \"${CODEBUDDYPLUGINROOT}/config.json\"], \"env\": { \"DBPATH\": \"${CODEBUDDYPLUGINROOT}/data\" } }, \"plugin api client\": { \"command\": \"npx\", \"args\": [\"@company/mcp server\", \" plugin mode\"], \"cwd\": \"${CODEBUDDYPLUGINROOT}\" } } } json { \"go\": { \"command\": \"gopls\", \"args\": [\"serve\"], \"extensionToLanguage\": { \".go\": \"go\" } } } json { \"name\": \"my plugin\", \"lspServers\": { \"go\": { \"command\": \"gopls\", \"args\": [\"serve\"], \"extensionToLanguage\": { \".go\": \"go\" } } } } json { \"name\": \"plugin name\", \"version\": \"1.2.0\", \"description\": \"Brief plugin description\", \"author\": { \"name\": \"Author Name\", \"email\": \"[email protected]\", \"url\": \"https://github.com/author\" }, \"homepage\": \"https://docs.example.com/plugin\", \"repository\": \"https://github.com/author/plugin\", \"license\": \"MIT\", \"keywords\": [\"ke"},{"id":"/cli/costs","title":"Cost Management","body":"Cost Management Optimize costs through multi scenario model selection and asynchronous compression strategies, achieving faster response times and lower usage costs while maintaining effectiveness. CodeBuddy Code consumes tokens with each interaction. Costs vary based on codebase size, query complexity, and conversation length. This document covers how to track costs, multi scenario model mechanisms, and how to reduce token consumption. Tracking Costs Using /cost Command The command provides detailed token usage statistics for the current session: Using /context Command The command analyzes current context usage, showing size distribution across different context types: Use to quickly identify what's consuming significant context space and optimize accordingly. Multi Scenario Model Mechanism Different task scenarios have different model capability requirements. Simple file searches and quick queries can be completed with lightweight models; complex architectural design and multi step reasoning require more powerful reasoning models. By automatically selecting different models for different scenarios, you can achieve: Optimal effectiveness: Complex tasks use high capability models to ensure quality Faster speed: Simple tasks use lightweight models for quicker responses Lower costs: Avoid using expensive high end models for simple tasks Scenario Types Scenario Type Description Typical Use Cases : : : Default model, balanced performance and cost General programming tasks, code writing Lightweight fast model, low cost and high speed File search, simple queries, quick operations Reasoning enhanced model, powerful analysis capability Complex analysis, architectural decisions, multi step reasoning Automatic Model Selection CodeBuddy Code automatically selects appropriate scenario models based on task type. When sub agents execute, the system automatically resolves the corresponding scenario model based on the user's currently selected main model. For example, lightweight s"},{"id":"/cli/tools-reference","title":"Tools Reference","body":"Tools Reference Complete reference for CodeBuddy Code's available tools, including permission requirements. CodeBuddy Code includes a set of built in tools to help understand and modify your codebase. The tool names in the table below are the identifiers used in , , and . Tool Description Requires Permission : : : Spawns a with an independent context window to handle tasks No Asks the user a multiple choice question to gather requirements or clarify ambiguities Yes Executes shell commands in your environment. See Yes Schedules recurring or one time tasks within the current session (expires on exit). See No Cancels a scheduled task by ID No Lists all scheduled tasks in the current session No Executes a deferred tool discovered via No Performs precise string replacement edits on files Yes Switches to plan mode for designing implementation approaches before coding No Creates an isolated and switches into it Yes Submits a plan for user approval and exits plan mode Yes Finds files using glob patterns No Searches file contents using regex patterns No Edits or modifies existing images based on text instructions Yes Generates images from text descriptions Yes Exits the worktree session and returns to the original directory Yes 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 and its language server binary No Performs multiple edits on the same file in a single atomic operation Yes Modifies Jupyter notebook cell contents Yes Reads file contents, supporting images, PDFs, and Jupyter notebooks No Sends messages to teammates in an No Executes a in the main conversation No Executes a custom Yes Returns structured output conforming to a JSON Schema No Creates a new task in the task list No Retrieves full details of a specific task No Lists all tasks w"},{"id":"/cli/channels-reference","title":"Channels Reference [Beta]","body":"Channels Reference [Beta] Beta Feature: Channels is currently in Beta. The protocol and interfaces may be adjusted based on feedback. A Channel is a special MCP server that pushes external events (webhooks, chat messages, monitoring alerts, etc.) into a CodeBuddy Code session, allowing CodeBuddy Code to react to things happening outside the terminal. Overview A Channel runs on the same machine as CodeBuddy Code and communicates via stdio. CodeBuddy Code launches it as a child process. Typical use cases: Chat platforms (Telegram, Discord): The plugin runs locally, polls the platform API for new messages, and forwards them to CodeBuddy Code Webhooks (CI, monitoring): A server listens on a local HTTP port, receives POST requests from external systems, and pushes them to CodeBuddy Code Channels operate in two modes: Mode Description One way Only forwards events to CodeBuddy Code (alerts, webhooks), processed in the local session Two way Additionally exposes a reply tool, allowing CodeBuddy Code to send responses Using a Channel Startup Use the parameter to specify which channels to load: Development Mode Use the flag to test custom channels during initial development. This flag allows any channel to run without being on the allowlist: This flag only bypasses the allowlist check; the organization policy still applies. Once a channel is submitted to the official marketplace and passes security review, it gets added to the allowlist and can be loaded directly with . Channel Messages in Sessions Channel messages are injected into CodeBuddy Code's context as tags: In the TUI, channel messages are displayed in a friendly format: Settings Channel functionality can be controlled in : Set to to completely disable channel functionality. Building a Channel Basic Requirements A channel server needs to: 1. Declare the capability so CodeBuddy Code registers a notification listener 2. Send events 3. Connect via stdio transport (CodeBuddy Code launches it as a child process) Minimal Ex"},{"id":"/cli/http-api","title":"CodeBuddy Code HTTP API <sup>Beta</sup>","body":"CodeBuddy Code HTTP API <sup Beta</sup Beta: This API is in Beta. Interfaces may be adjusted. Feedback is welcome. CodeBuddy Code provides two public interface sets for developers building Agent applications: REST API ( ) — Stateless HTTP request/response, suitable for webhook integration, management operations, and simple queries ACP ( ) — Stateful streaming protocol (JSON RPC over SSE), suitable for building full Agent client applications Quick Start Starting the HTTP Service API Documentation (Swagger UI) Once the service is running, visit: Interactive docs: OpenAPI spec: Swagger UI provides an interactive testing interface for all public endpoints. Verify the Service API Layers Layer Route Prefix Compatibility Promise Description Public REST API Semantic versioning, no breaking changes Covered in this document Public ACP Protocol Follows ACP specification Full conversation capabilities, see Internal RPC No compatibility guarantee For internal CLI use, not publicly available Authentication Two modes are supported (controlled by environment variable ): Mode Value Description No authentication (default) For local development, no authentication required Password authentication Automatically enabled for remote access Password authentication supports the following methods (any one passing is sufficient): Response Format All endpoints use a unified envelope format: Endpoint Overview System Method Endpoint Description GET Health check GET Environment info (version, OS, CWD, etc.) GET System resource metrics + instance process metrics GET Environment variables (aligned with E2B envd) Authentication Method Endpoint Description GET Get authentication status POST Password login, returns token Runs (Agent Execution) Method Endpoint Description POST Initiate Agent execution (async, returns runId) GET Query execution status GET SSE streaming of execution results POST Cancel execution Webhooks (Third party Platform Integration) Method Endpoint Description GET Platform URL verif"},{"id":"/cli/sdk","title":"CodeBuddy Agent SDK","body":"CodeBuddy Agent SDK Version Requirements: This documentation is for CodeBuddy Agent SDK v0.1.0 and above. Feature Status: The SDK is currently in Preview stage, and interfaces and behaviors may be adjusted in future versions. ::: warning Important: Environment Isolation The SDK does not load any filesystem configurations by default, including , , MCP servers, sub agents, slash commands, Rules, and Skills. This is a key difference from direct CLI usage, ensuring SDK application behavior is completely controlled by code with predictability and consistency. To load these configurations, use the option to explicitly specify. See section for details. ::: CodeBuddy Agent SDK allows you to programmatically control CodeBuddy Agent in your applications. It supports TypeScript/JavaScript and Python, enabling scenarios such as automated task execution, custom permission control, and building AI powered development tools. Why Use the SDK CodeBuddy Agent SDK gives you programmatic access to all of CodeBuddy's capabilities, not just through command line interaction. Beyond Command Line Programmatic Control: Embed AI programming assistants in your applications to implement automated workflows Custom Interactions: Build user interfaces and interaction methods that suit your needs Batch Processing: Perform batch AI operations on multiple files or projects Integrate with Existing Systems: Seamlessly integrate AI capabilities into CI/CD, IDE plugins, or other development tools Fine grained Control Permission Management: Implement enterprise level permission policies through callbacks Behavior Customization: Use the Hook system to intercept and modify Agent behavior Resource Limits: Control token consumption, execution time, and budget Session Management: Persist and restore conversation contexts Extended Capabilities Custom Agents: Create specialized sub agents to handle domain specific tasks MCP Integration: Connect custom tools and services Multi model Support: Flexibly switch and c"},{"id":"/cli/sdk-python","title":"Python SDK Reference","body":"Python SDK Reference Version Requirement: This document is for CodeBuddy Agent SDK v0.1.0 and above. This document provides a complete API reference for the Python SDK. For quick start and usage examples, please refer to . Requirements Dependency Version Requirement Python = 3.10 CodeBuddy CLI Installed Async Runtime: The SDK is based on , all APIs are asynchronous. Installation Recommended to use for dependency management: Or using pip: Environment Variables Variable Name Description Required CodeBuddy CLI executable path Optional If not set, the SDK will look for CLI in the following order: 1. Environment variable 2. Built in binary within SDK package 3. Development environment monorepo path Authentication Configuration The SDK supports authentication using existing login credentials, API Key, or OAuth Client Credentials. See for details. Functions query() Main API entry point, creates a query and returns an async iterator of messages. Parameters: Parameter Type Description Query prompt or user message stream Configuration options (optional) Custom transport layer (optional) Returns: Async iterator of messages Example: Client Class CodeBuddySDKClient Client class for bidirectional interactive conversations. Supports multi turn dialogues, interruptions, and dynamic control. Methods: connect() Connect to CodeBuddy. query() Send user message. receiveresponse() Receive messages until a ResultMessage is received. receivemessages() Receive all messages (does not auto stop). disconnect() Disconnect. Context Manager Support: mcpserverstatus() Get MCP server connection status. Authentication The SDK provides an independent authentication API with a two phase design: first obtain the login URL, then wait for the user to complete authentication. authenticate() Start the authentication flow, returns an object. Parameters: Parameter Type Description Authentication method identifier (default ) Predefined environment name Custom endpoint URL (mutually exclusive with environment)"},{"id":"/cli/sdk-typescript","title":"TypeScript SDK Reference","body":"TypeScript SDK Reference Version Requirements: This documentation is for CodeBuddy Agent SDK v0.1.0 and above. This document provides a complete API reference for the TypeScript SDK. For quick start and usage examples, please refer to . Requirements Dependency Version Requirement Node.js = 18.0.0 TypeScript = 5.0.0 (Recommended) Runtime Support: Node.js (Recommended) Bun Deno Installation Or use other package managers: Environment Variables Variable Name Description Required CodeBuddy CLI executable path Optional Authentication Configuration The SDK supports authentication using existing login credentials, API Key, or OAuth Client Credentials. See for details. Functions query() Main API entry point that creates a query and returns a message stream. Parameters: Parameter Type Description Query prompt or user message stream Configuration options (optional) Return Value: Interface that extends Query Interface Constants Errors Unstable V2 API Warning: The following APIs are experimental and may change in future versions. unstablev2createSession() Create a new interactive session. unstablev2resumeSession() Resume an existing session. unstablev2prompt() Convenience function for single query. unstablev2authenticate() Initiate an interactive login flow with support for multi environment authentication (international, China, etc.). Parameters: Field Type Description Authentication URL callback, used to open a browser or display the link Predefined environment (mutually exclusive with endpoint) Custom endpoint URL (for selfhosted, mutually exclusive with environment) Authentication method ID, default Timeout in milliseconds, default 300000 CLI executable path (optional) Environment variables (optional) Returns: User info object containing userId, userName, userNickname, token, and other fields Example: Behavior: If a valid token already exists, returns user info directly without triggering the login flow Otherwise, notifies the user to open the login link via the callback Aft"},{"id":"/cli/sdk-hooks","title":"SDK Hook System","body":"SDK Hook System Version Requirements: This documentation is for CodeBuddy Agent SDK v0.1.0 and above. This document explains how to use the Hook system in the SDK to insert custom logic before and after tool execution. Table of Contents Overview Hooks allow you to insert custom logic during CodeBuddy's session lifecycle, enabling: Validation and interception before tool calls Logging after tool execution Review of user submitted content Initialization and cleanup at session start/end Custom workflows for creation and cleanup Supported Events Event Trigger Timing Before tool execution After successful tool execution When user submits a message When main Agent response ends When sub agent ends Before context compression When creating an isolated When deleting an isolated When a checkpoint is automatically created after file modifications Hook Configuration Configure hooks through the option. Each event can have multiple matchers, and each matcher can have multiple hook callbacks. Basic Structure ::: code group ::: HookMatcher Structure Field Type Description Match pattern, supports regex. or empty string matches all Array of callback functions Timeout (milliseconds in TypeScript, seconds in Python) Matcher Patterns Exact match: only matches Bash tool Regex match: matches Edit or Write Wildcard: or matches all tools Prefix match: matches all MCP tools Event Types PreToolUse Triggered before tool execution, can block execution or modify input. ::: code group ::: PostToolUse Triggered after successful tool execution, can add extra context. ::: code group ::: UserPromptSubmit Triggered when user submits a message, can add context or block processing. ::: code group ::: Stop / SubagentStop Triggered when Agent response ends, can block stopping and request continuation. ::: code group ::: unstableCheckpoint (Experimental) Automatically triggered after file modifications (when Write/Edit/MultiEdit tools execute successfully), providing file snapshots and change statistics. :"},{"id":"/cli/sdk-permissions","title":"SDK Permission Control","body":"SDK Permission Control Version Requirement: This document is for CodeBuddy Agent SDK v0.1.0 and above. This document explains how to implement permission control in the SDK, including permission modes, canUseTool callbacks, and tool whitelists/blacklists. Table of Contents Overview CodeBuddy Agent SDK provides multiple permission control mechanisms: Mechanism Description Use Case Permission Modes Global permission behavior control Quick setup of overall policy canUseTool Callback Runtime dynamic approval Interactive permission confirmation Tool Whitelists/Blacklists Declarative tool filtering Static policy configuration Permission Modes Set global permission behavior through (TypeScript) or (Python). Available Modes Mode Description Default mode, all tool operations require confirmation Auto approve file edits, other operations still require confirmation Planning mode, only read only tools allowed Skip all permission checks (use with caution) Initial Configuration ::: code group ::: Dynamically Modifying Permission Mode Using Session/Client API allows you to dynamically modify permission mode at runtime: ::: code group ::: canUseTool Callback The callback is triggered when a tool requires permission confirmation, allowing you to implement custom permission logic. Callback Signature ::: code group ::: Complete Example: Interactive Approval ::: code group ::: Modifying Tool Input You can modify tool input parameters in : ::: code group ::: Handling AskUserQuestion When AI needs to ask the user a question, it calls the tool. You need to handle this tool in . Input Structure Returning Answers ::: code group ::: Tool Whitelists/Blacklists Use and to declaratively control tool access. Configuration Example ::: code group ::: Common Tool Names Tool Name Functionality Read files Write files Edit files File pattern matching Content search Execute shell commands Sub agent tasks Fetch web content Web search Best Practices 1. Use mode by default: Provides the most complete perm"},{"id":"/cli/sdk-sessions","title":"SDK Session Management","body":"SDK Session Management Version Requirement: This document is for CodeBuddy Agent SDK v0.1.0 and above. This document explains how to manage sessions in the SDK, including obtaining session IDs, resuming sessions, forking sessions, and multi turn conversations. Table of Contents Overview Session is a core concept in CodeBuddy, used for: Maintaining conversation context: AI can remember previous content in multi turn conversations Supporting session resumption: Can continue from where you left off Supporting session forking: Create branches from a certain point to explore different directions Each session has a unique that can be used for subsequent resumption. Obtaining Session ID When a session starts, the SDK returns an initialization message of type containing the . Using query API ::: code group ::: Using v2 Session API (TypeScript) Using Client API (Python) Resuming Sessions Using a previously saved allows you to resume a session and continue the previous conversation. Using resume option ::: code group ::: Continuing the most recent session Using the / option automatically continues the most recent session: ::: code group ::: Multi turn Conversations Multi turn conversations allow multiple interactions within the same session while maintaining context coherence. TypeScript: Using query API Each new query call uses to resume the session: TypeScript: Using v2 Session API v2 API provides a more concise multi turn conversation experience: Python: Using CodeBuddySDKClient Related Documentation Quick start and usage examples Permission modes and canUseTool Complete API reference Complete API reference"},{"id":"/cli/sdk-custom-tools","title":"SDK Custom Tools Guide","body":"SDK Custom Tools Guide Version Requirement: This documentation is for CodeBuddy Agent SDK v0.2.0 and above. Feature Status: SDK Custom Tools is a Preview feature of the CodeBuddy Agent SDK. This document explains how to create and use custom tools in the CodeBuddy Agent SDK. Custom tools allow you to define specialized functionality that Agents can invoke to complete specific tasks. Overview Custom Tools is a way provided by the CodeBuddy Agent SDK to create custom tools through MCP (Model Context Protocol). Unlike configuring external MCP servers, Custom Tools allows you to define tools directly within your application without requiring a separate process or server. Core Advantages In process Execution: Tools execute within the application, no need to create separate processes Type Safety: Full TypeScript type checking and type inference support Simplified Deployment: No need to deploy MCP servers separately, everything deploys with the application Tight Integration: Share memory and state with the application Zero Additional Dependencies: Leverages existing SDK infrastructure Quick Start TypeScript Create a simple calculator tool: Python Python SDK uses decorator pattern for defining tools: Creating Custom Tools TypeScript Basic Tool Definition TypeScript Complete Example: File Analysis Tool Python Decorator Pattern Managing Multiple Tools TypeScript Python Type Safety TypeScript Using Zod Schema Zod provides runtime type validation and powerful type inference: Python Type Annotations Python SDK uses standard type annotations: Complete Example: Database Query Tool TypeScript Python Complete Example: API Integration Tool TypeScript Python Selectively Allowing Tools You can selectively allow specific tools to be called: TypeScript Python Error Handling TypeScript API Call Error Handling Python API Call Error Handling Best Practices 1. Use Clear Parameter Types and Descriptions Provide clear types and descriptions for tool parameters to help of the Agent understand h"},{"id":"/cli/sdk-mcp","title":"SDK MCP Integration Guide","body":"SDK MCP Integration Guide Version Requirement: This documentation is for CodeBuddy Agent SDK v0.1.24 and above. Feature Status: SDK MCP support is a Preview feature of the CodeBuddy Agent SDK. This document explains how to integrate and use MCP (Model Context Protocol) servers in the CodeBuddy Agent SDK, extending your applications with custom tools and functionality. Overview MCP servers allow you to integrate custom tools, resources, and prompts into the CodeBuddy Agent SDK. Through the SDK, you can programmatically enable these tools, adding domain specific capabilities to your AI workflows. Core Concepts MCP Server: A standalone process or service that provides tools, resources, and prompts Tools: Executable functions exposed by MCP servers Resources: Readable data or files provided by MCP servers Prompts: Templated prompts provided by MCP servers Supported Transport Types CodeBuddy Agent SDK supports three MCP server communication methods: Transport Type Use Case Description STDIO Local tools Communicate with local processes via standard input/output HTTP/SSE Remote services Communicate with remote services via HTTP streaming or Server Sent Events SDK MCP IDE/SDK integration MCP servers registered by external SDKs (like IDE extensions) Configuring MCP Servers supports two configuration methods: 1. Object format: Define server configuration directly in code 2. File path string: Point to an MCP configuration file (JSON format) Object Format Use the option to configure MCP servers. Configuration supports STDIO, HTTP, and SSE transport types. TypeScript: Python Python: File Path Format You can also pass an MCP configuration file path. The configuration file is in JSON format, with the same structure as the CLI parameter. TypeScript: Python: Configuration file format example ( ): Note: When using file path format, SDK MCP type ( ) server configuration is not supported. SDK MCP servers are only available in object format. Server Configuration Details STDIO Configurat"},{"id":"/cli/sdk-demos","title":"SDK Demo Projects","body":"SDK Demo Projects This document introduces the official demo projects for CodeBuddy Agent SDK, helping you quickly understand various SDK usage scenarios. Demo Repository All demo code is hosted in the official repository: Repository URL: <https://cnb.cool/codebuddy/agent sdk demos Demo Overview Demo Language Core Features Use Case quick start TypeScript Basic API, Message Streaming, Hooks SDK Getting Started multi turn session TypeScript Multi turn Conversations, Session Recovery Interactive Applications research assistant Python Multi Agent Collaboration Complex Task Decomposition profile builder TypeScript Web Search, Document Generation Information Collection chat demo TypeScript WebSocket, Streaming Response Web Applications mail assistant TypeScript MCP Protocol, Custom Tools Business System Integration spreadsheet assistant TypeScript Electron IPC Desktop Applications Environment Setup Prerequisites or Node.js 18+ Python 3.10+ (for Python demos) CodeBuddy CLI login authentication completed Install SDK ::: code group ::: Authentication Methods SDK supports multiple authentication methods: 1. Reuse CLI Login State: If you have logged in via the command, SDK automatically uses existing credentials 2. API Key Authentication: Configure via environment variables For detailed authentication configuration, please refer to Basic Demos quick start: SDK Getting Started Demonstrates basic usage of the API, including message stream handling and Hooks mechanism. Run Demo: multi turn session: Multi turn Conversations Demonstrates Session API for multi turn conversations and session recovery. Run Demo: Advanced Demos research assistant: Multi Agent Collaboration Python demo showing how to define multiple specialized sub agents collaborating on complex tasks. Workflow: 1. Main Agent breaks down research requests into subtasks 2. Researcher uses WebSearch to gather information, saves to 3. Data Analyst extracts data from research notes, generates charts to 4. Report Writer con"},{"id":"/cli/release-notes/README","title":"Release Notes","body":"Release Notes Release notes for CodeBuddy Code, covering feature updates and improvements for end users. About Release Notes Release Notes document user visible changes in each version, including: New Features Improvements Bug Fixes Difference from CHANGELOG.md: Release Notes: User facing, emphasizing feature value and user experience CHANGELOG: Developer facing, recording technical details and code changes Version History <! New versions are automatically added here 2026 04 07 2026 04 05 2026 04 05 2026 04 04 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 02 2026 04 01 2026 04 01 2026 03 31 2026 03 31 2026 03 30 2026 03 30 2026 03 28 2026 03 26 2026 03 26 2026 03 25 2026 03 25 2026 03 25 2026 03 24 2026 03 23 2026 03 23 2026 03 19 2026 03 18 2026 03 18 2026 03 17 2026 03 17 2026 03 16 2026 03 15 2026 03 13 2026 03 13 2026 03 13 2026 03 12 2026 03 12 2026 03 12 2026 03 12 2026 03 11 2026 03 11 2026 03 11 2026 03 09 2026 03 07 2026 03 06 2026 03 06 2026 03 05 2026 03 05 2026 03 03 2026 03 03 2026 03 02 2026 02 28 2026 02 28 2026 02 28 2026 02 26 2026 02 26 2026 02 25 2026 02 24 2026 02 19 2026 02 19 2026 02 14 2026 02 14 2026 02 13 2026 02 13 2026 02 12 2026 02 12 2026 02 11 2026 02 11 2026 02 11 2026 02 10 2026 02 10 2026 02 09 2026 02 08 2026 02 06 2026 02 05 2026 02 04 2026 02 04 2026 02 04 2026 02 03 2026 02 03 2026 02 02 2026 02 02 2026 02 02 2026 01 31 2026 01 31 2026 01 30 2026 01 30 2026 01 29 2026 01 28 2026 01 28 2026 01 28 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 26 2026 01 26 2026 01 25 2026 01 25 2026 01 24 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 22 2026 01 22 2026 01 22 2026 01 22 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 20 2026 01 20 2026 01 20 2026 01 20 2026 01 19 2026 01 18 2026 01 17 2026 01 17 2026 01 16 2026 01 15 2026 01 15 2026 01 15 2026 01 14 2026 01 14 2026 01 13 2026 01 12 2026 01 09 2026 01 09 2026 01 08 2026 01 08 2026 01 07 2026 01 06 2026 01 06"},{"id":"/cli/release-notes/v2.79.0","title":"🚀 CodeBuddy Code v2.79.0 Release","body":"🚀 CodeBuddy Code v2.79.0 Release ✨ New Features Daemon Mode & Background Sessions Added Daemon process support, allowing you to manage background running CLI instances via commands. Also supports the flag to launch tasks in the background, with commands for full lifecycle management of background tasks. Web UI Workers & Log Management The Web UI now includes a Workers page for visual management of all Worker processes and Daemons, supporting start, stop, and terminate operations. Also added a standalone log viewer supporting 4 log types (telemetry/process/debug/conversation) switching, keyword search, and syntax highlighting. System Monitoring View The Web UI now includes a Metrics page displaying system CPU, memory, and disk usage overview, as well as per instance process level resource metrics (RSS, Heap, uptime), with 8 second auto polling refresh to help you stay on top of resource status at all times. Editor Experience Major Upgrade Tab Enhancements: Support drag to reorder, pinned tabs (Pin), overflow scroll arrows, and an 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 Cmd+P / Ctrl+P to quickly search and open files File Preview: Support image preview (zoom/drag/checkerboard background), Markdown, PDF, SVG preview, and binary file info pages Status Bar: Bottom bar displays cursor position, selection info, language type, and other editing status Recent Files: Empty editor page shows a list of recently opened files 🔧 Improvements Execution Phase Tracking: The 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 Background Task Support Expansion: stream json and headless modes now support background tasks; only print mode ( ) retains its origina"},{"id":"/cli/release-notes/v2.78.1","title":"🚀 CodeBuddy Code v2.78.1 Release","body":"🚀 CodeBuddy Code v2.78.1 Release 🐛 Bug Fixes Agent Resolution Fix: Fix the issue where the wrong Agent was used during queue drain and Agent wake up. Now the session associated Agent is used consistently, ensuring more accurate and reliable task scheduling Model Field Fix: Fix the model field value issue for reasoningitem and regular items. Actual model response information is now used instead of potentially empty values, ensuring complete and accurate model information 🔧 Improvements WeCom Reply Enhancement: Enhanced chatId parsing to support extracting routing information from chatId strings; optimized tool return format to structured JSON, improving message processing reliability"},{"id":"/cli/release-notes/v2.78.0","title":"🚀 CodeBuddy Code v2.78.0 Release","body":"🚀 CodeBuddy Code v2.78.0 Release ✨ New Features Agent Teams Web UI Support A brand new Agent Teams Web UI experience that lets you intuitively manage and monitor multi Agent collaborative tasks in the browser: Real time Progress Tracking: Team members' running status, token usage, and tool invocation counts are pushed in real time via SSE, giving you an at a glance overview in the task panel Member Conversation Viewer: Click any member to view their complete conversation history with real time streaming updates Smart Message Display: Incoming messages show , outgoing messages show , with each member having a unique color identifier State Recovery on Refresh: Team state and member conversations are automatically restored after page refresh, no manual reconnection needed Full Internationalization: Added 13 Team related translations in both Chinese and English 🔧 Improvements Permission System Refactor: Refactored ACP permission broadcast mechanism to support restoring permission dialogs after Web UI page refresh, fixing cross client permission sync issues Questionnaire Delivery Optimization: AskUserQuestion is now delivered via the interruption broadcast protocol, preventing questionnaires from being sent to the wrong client in multi connection scenarios Context Compaction Improvement: Replaced manual truncation with a synchronous compact flow, improving the reliability of context management Channel Message Queue: Added a message queue mechanism for WeChat/WeCom channels to prevent concurrent message loss while an Agent is running Option Compatibility Handling: Added defensive handling for plain string option arrays in TUI and Web UI questionnaire panels 🐛 Bug Fixes Command Completion Fix: Fix the issue where the completion menu disappears after typing a slash command followed by arguments. Now typing something like still correctly shows command completion suggestions Command Suggestion Fix: Fix the issue where command completion keeps showing after the cursor moves"},{"id":"/cli/release-notes/v2.77.1","title":"🚀 CodeBuddy Code v2.77.1 Release","body":"🚀 CodeBuddy Code v2.77.1 Release 🔧 Improvements Image Blob Reference Rehydration: Added the environment variable. When set to , image blob references are automatically rehydrated to full base64 data during mode streaming output, facilitating downstream system integration WeChat/WeCom Permission Reply UX Optimization: Removed mechanical confirmation messages after permission operations; Agent's subsequent actions now serve as implicit feedback, making conversations more natural and fluent 🐛 Bug Fixes WeChat/WeCom Message Routing Fix: Fix a bug where the \"Always Allow\" directive in permission replies was incorrectly recognized due to a check order issue, ensuring permission directives are correctly prioritized"},{"id":"/cli/release-notes/v2.77.0","title":"🚀 CodeBuddy Code v2.77.0 Release","body":"🚀 CodeBuddy Code v2.77.0 Release ✨ New Features Plugin System Major Upgrade The plugin system has received a major enhancement, significantly improving plugin installation, management, and extensibility: Multi source Installation: Support installing plugins via npm packages and Git repository subdirectories, flexibly adapting to different plugin distribution methods MCP Bundle Support: Support loading pre packaged MCP services (.mcpb/.dxt/.zip) from remote URLs or local files, simplifying MCP service integration Output Style Extension: Plugins can provide custom output styles to personalize Agent output presentation Default Agent Configuration: Plugins support setting a default Agent via , serving as the lowest priority base layer PATH Auto injection: Enabled plugins' directories are automatically injected into the Bash tool's PATH User Configuration Options: Plugins support defining fields for interactive user configuration collection during installation Dependency Resolution: Support DFS closure algorithm for resolving plugin transitive dependencies, including cycle detection Plugin Security & Management Marketplace Name Protection: Four layer defense mechanism to prevent third party impersonation of the official marketplace Enterprise Policy Service: Control plugin enable/disable via managed settings to meet enterprise compliance requirements Flag: Support loading plugins from a local directory for development and testing Command: Reload all plugin components without restarting Command: Four layer validation of plugin directory structure and manifest validity 🔧 Improvements Venus Endpoint Compatibility Adapter: Support Prompt cache injection and request field sanitization for Venus OpenAI compatible proxy endpoints; model adapters and endpoint adapters can be stacked SDK MCP Tool Filter: Ensure permission and deny rules are correctly applied to custom tools registered via the SDK 🐛 Bug Fixes AskPanel Race Condition Fix: Fix the invocation order issue between d"},{"id":"/cli/release-notes/v2.76.0","title":"CodeBuddy Code v2.76.0 Release","body":"CodeBuddy Code v2.76.0 Release New Features GLM 5v Turbo Model Launch: Added GLM 5v Turbo multimodal vision model with image understanding capabilities, enabling the AI assistant to analyze and understand image content. Simultaneously launched on both the domestic and iOA versions Bug Fixes Model Temperature Configuration Fix: Fixed an issue where the temperature parameter for some models was incorrectly hardcoded to the default value of 1. Now correctly reads the temperature value specified in the product configuration for each model, ensuring models run with optimal parameters"},{"id":"/cli/release-notes/v2.75.0","title":"CodeBuddy Code v2.75.0 Release","body":"CodeBuddy Code v2.75.0 Release Improvements WeChat Instance ID Dynamic Update: After WeChat client QR code authentication, the temporary instance ID is automatically updated to the real ID, ensuring subsequent message replies are correctly routed to the corresponding WeChat account WeChat Message Send Error Checking: Added return value validation to the message sending interface, throwing clear error messages on send failure to facilitate troubleshooting"},{"id":"/cli/release-notes/v2.74.0","title":"CodeBuddy Code v2.74.0 Release","body":"CodeBuddy Code v2.74.0 Release New Features Side Question Command /btw Use to quickly ask a side question while the Agent is working, without interrupting the current task. Answers are generated instantly based on the existing context, making it easy to confirm details or get supplementary information during complex tasks. Improvements Channel Session Suggestion Confirmation: After completing a conversation round through WeChat/WeCom channels, follow up suggestions are automatically generated and wait for user confirmation before execution, preventing unnecessary automated actions Bug Fixes AskUserQuestion Panel Stability: Fixed an issue where the question and answer panel could crash when the model returned incomplete option data"},{"id":"/cli/release-notes/v2.73.0","title":"CodeBuddy Code v2.73.0 Release","body":"CodeBuddy Code v2.73.0 Release New Features Channel Suggestion Confirmation After completing a conversation round through WeChat/WeCom channels, the system automatically generates next step action suggestions and sends them to the user for confirmation. Reply with \"y\" to continue execution, making channel interactions smoother and more natural. Improvements WeChat/WeCom Three Option Permissions: Permission request prompts upgraded from to , supporting remembered choices to reduce repetitive confirmations Permission Deadlock Fix: Replying with non option content in WeChat/WeCom no longer causes a deadlock; the system automatically denies the current permission and processes the input as a new message Context Compaction Optimization: Automatically cleans up stale tool results older than 1 hour before compaction, reducing compaction input tokens by 80%+ in practice and significantly lowering compaction costs Image Content Stripping: Automatically replaces images with placeholders before compaction, preventing meaningless image tokens from entering the summary Compaction Prompt Enhancement: Improved 9 section structured summary format for better compaction quality and information retention JSON Repair Enhancement: Replaced custom repair logic with the jsonrepair library, supporting repair of Chinese quotes, missing commas, truncated JSON, and more malformed scenarios, reducing unnecessary model retries Bug Fixes Channel Message Slash Commands: Fixed an issue where slash commands sent from WeChat and other channels were wrapped in tags and could not be correctly recognized Queue Message Command Preservation: Slash commands are now preserved during message queue processing and executed through the normal pipeline once the agent is idle, preventing commands from being silently dropped"},{"id":"/cli/release-notes/v2.72.0","title":"🚀 CodeBuddy Code v2.72.0 Release","body":"🚀 CodeBuddy Code v2.72.0 Release ✨ New Features File Changes Panel The Web UI now includes a Changes view that lets you see all files modified by the Agent in real time. Click any file to open the Monaco Diff Editor, which displays the specific changes for each file with syntax highlighting. Checkpoint Rollback Added powerful code rollback capabilities with three flexible rollback modes: Per file revert: Precisely revert changes to a single file Checkpoint rollback: Return to a previous conversation node Multi mode selection: Roll back code only, conversation only, or both 🔧 Improvements Diff Viewing Upgrade: Migrated from custom diff algorithm to Monaco DiffEditor with syntax highlighting support and smoother large file viewing File Icon Optimization: Eliminated icon flickering during loading for smoother file list display Session State Restoration: Automatically restores the file changes panel state after page refresh, preserving context Real time Change Notifications: All connected clients receive real time notifications when the Agent modifies files Plugin Management API: Added public REST APIs for managing plugin installation, uninstallation, enabling, and disabling Configuration Management API: Added public REST APIs for querying and modifying configuration with scope based operations Clipboard Compatibility Enhancement: Added JXA NSPasteboard fallback for macOS image pasting, improving compatibility with third party screenshot tools like WeCom Message Notification Optimization: Improved Chinese descriptions for tool operations in WeChat and WeCom Channels for better readability"},{"id":"/cli/release-notes/v2.71.1","title":"CodeBuddy Code v2.71.1 Release","body":"CodeBuddy Code v2.71.1 Release Improvements SDK MCP Timeout Mechanism: Replaced fixed timeouts with an AbortSignal cancellation mechanism, supporting long running MCP tool calls and preventing complex tools from being unexpectedly interrupted by timeouts Reasoning Model Configuration: Automatically defaults effort to high when thinking mode is enabled, ensuring the model actually produces reasoning output Product Configuration Fix: Corrected a typo in the reasoning field of the model configuration"},{"id":"/cli/release-notes/v2.71.0","title":"CodeBuddy Code v2.71.0 Release","body":"CodeBuddy Code v2.71.0 Release New Features Web UI Code Editor The Web UI now includes file browsing and code editing capabilities, allowing you to view and edit project files directly in the browser: Directory Tree Navigation: The left panel displays the project file structure for quick file access Multi Tab Editing: Open multiple files simultaneously and switch freely between tabs Monaco Editor: Integrated with the same editor engine as VS Code, with syntax highlighting support Auto Save: Edits are automatically saved without manual action File Drag & Drop: Support for moving files via drag and drop Keyboard Shortcuts: Common keyboard shortcuts supported for improved editing efficiency Improvements Streaming Timeout Optimization: Increased the default streaming response timeout and first token timeout from 2 minutes to 10 minutes, reducing timeout interruptions during complex tasks caused by slower model responses. Can still be customized via and environment variables"},{"id":"/cli/release-notes/v2.70.1","title":"CodeBuddy Code v2.70.1 Release","body":"CodeBuddy Code v2.70.1 Release Security Fixes CORS Cross Origin Attack Protection Fixed a cross origin request security vulnerability in the local Gateway service ( ). Previously, malicious web pages could use JavaScript to make cross origin requests to the user's local localhost service, executing Agent commands or stealing output data. Key fixes: Replaced the framework's default with a precise allowlist mechanism, only permitting cross origin requests from localhost, 127.0.0.1, and Tunnel URLs Added Host header validation middleware to prevent DNS Rebinding attacks Fixed CORS wildcard vulnerability on SSE streaming endpoints Changed the default bind address from to to prevent the service from being exposed to the local network Improvements Custom CORS Rules: Support configuring allowed cross origin sources via the environment variable (comma separated) or the Settings option, accommodating special use cases"},{"id":"/cli/release-notes/v2.70.0","title":"CodeBuddy Code v2.70.0 Release","body":"CodeBuddy Code v2.70.0 Release New Features Model Driven Built in Command Invocation AI models can now directly execute certain built in slash commands (such as /clear, /model, /config, /resume, /gateway, etc.) through the Skill tool, enabling model proxied command execution in non terminal scenarios like WebChat and WeChat without requiring users to manually type slash commands. Commands like /model, /config, /resume now support a subcommand to display available options in text format The field provides unified control over whether built in and custom commands can be invoked by the model Improvements Instance Registration URL Simplification: Merged localUrl/tunnelUrl into a unified url field, with the backend automatically determining the best reachable address, simplifying configuration Permission Dialog Stability: Replaced the useEffect subscription pattern with useSyncExternalStore, completely resolving the race condition that occasionally prevented permission dialogs from appearing Session Permission Mode Persistence: Fixed the issue where permission mode was reset when switching sessions in multi instance scenarios"},{"id":"/cli/release-notes/v2.69.0","title":"CodeBuddy Code v2.69.0 Release","body":"CodeBuddy Code v2.69.0 Release New Features E2B Compatible API Fully aligned with the E2B open protocol, allowing CodeBuddy Code to be used as an E2B compatible sandbox environment: File System API: Added and endpoints, supporting file read/write, directory operations, file watching, and other comprehensive file system capabilities Process Management API: Added endpoints, supporting process launching (PTY/pipe), input/output streaming, signal sending, and full lifecycle management System Metrics & Environment Variables API: Added and endpoints, providing CPU/memory/disk usage metrics and environment variable queries Improvements PTY Terminal Enhancement: Added SSE output streaming, HTTP input sending, and HTTP resize endpoints, providing a pure HTTP alternative to WebSocket Terminal Web UI Refactoring: Migrated the frontend terminal component from WebSocket to SSE + HTTP communication, improving cross platform compatibility Distributed Tracing: Refactored the trace pipeline based on the Hook mechanism, supporting SDK passed traceId for end to end tracing with automatic child Span creation for each tool call WeChat Multi Instance Support: Enabled simultaneous connections to multiple WeChat bot instances with automatic message routing to the correct client WeChat Media Messages: Added support for receiving and sending images, files, voice, and video messages Chinese Quotation Mark Fix: Automatically corrects Chinese quotation marks in model output to prevent JSON parsing failures in tool calls Security Fixes WeCom SSRF Protection: Added URL allowlist validation for WeCom bot media downloads, restricting access to official WeCom CDN domains only to prevent Server Side Request Forgery attacks"},{"id":"/cli/release-notes/v2.68.0","title":"🚀 CodeBuddy Code v2.68.0 Release","body":"🚀 CodeBuddy Code v2.68.0 Release ✨ New Features Web UI Documentation Viewer Added a documentation browsing feature in the Web UI, allowing you to access CLI documentation without leaving your workspace: Full text search for quickly locating the content you need Language switching between Chinese and English to suit different preferences Table of contents navigation and TOC for easy browsing of long documents API Reference quick links for direct access to Swagger UI Support for opening in a new tab as a standalone full screen view CLI documentation is automatically bundled at build time, supporting offline viewing 🔧 Improvements HTTP API Standardization: All public endpoints unified under the prefix with version control support; internal endpoints migrated to for a clearer structure API Documentation: Added Swagger UI ( ) and OpenAPI specification ( ) for developers to explore and debug APIs Unified Response Format: Public endpoints adopt the standard / envelope format, improving API consistency ACP Endpoint Migration: ACP protocol endpoints migrated from to , unifying the routing prefix with REST APIs Credential Storage Optimization: WeChat and WeCom credentials consolidated into a single file format, with automatic migration from legacy formats API Response Compatibility: Web UI adapted to the unified envelope format, ensuring correct parsing of REST endpoint responses 🐛 Bug Fixes Confirmation Dialog Display: Fixed an issue where the AskUserQuestion confirmation dialog occasionally failed to appear, resolving a race condition in route navigation Documentation Link Format: Corrected the format of localhost links in the Channels documentation"},{"id":"/cli/release-notes/v2.67.0","title":"🚀 CodeBuddy Code v2.67.0 Release","body":"🚀 CodeBuddy Code v2.67.0 Release ✨ New Features WeCom Channel Bridge WeCom AI Bot messages can now be injected directly into Agent sessions through the channel system, with support for replying with markdown formatted messages using the WeComReply tool, covering both group chat and private chat scenarios. Multi Instance Access and Management Both WeChat and WeCom support connecting multiple bot instances simultaneously Interactively add and manage connections through the panel WeChat binds directly via QR code scanning, WeCom auto connects after entering Bot ID + Secret, with credentials persisted to disk Web UI Remote Control Management Added a remote control page with visual management of channel connections (connect/disconnect/unbind/delete), including WeChat QR scanning and WeCom form based addition. WeCom Media Message Support WeComReply tool now supports uploading and sending media messages including images, files, and videos Supports receiving image and file messages sent by users with automatic download and decryption Improved image and file message handling for WeChat Customer Service 🔧 Improvements Environment variable control for max turns: Support controlling the maximum execution turns for the main Agent and sub Agents separately via and environment variables WeCom media decryption: Aligned with the official SDK using AES 256 CBC algorithm, added automatic format detection 🐛 Bug Fixes Rewind phantom diff: Fixed the issue where rewind after compact showed non existent file changes; compact messages now correctly inherit file snapshot state PTY file descriptor leak: Enhanced fd cleanup logic for PTY service and background tasks, ensuring proper resource release even on error paths"},{"id":"/cli/release-notes/v2.66.2","title":"🚀 CodeBuddy Code v2.66.2 Release","body":"🚀 CodeBuddy Code v2.66.2 Release 🐛 Bug Fixes Model settings sync: Fixed an issue where options were not synchronized when setting the model via SDK/control signals, ensuring model selection remains consistent across all read paths"},{"id":"/cli/release-notes/v2.66.1","title":"🚀 CodeBuddy Code v2.66.1 Release","body":"🚀 CodeBuddy Code v2.66.1 Release 🔧 Improvements Channel permission relay: Supports confirming tool permission requests via Channels (such as WeChat). Channels that declare permission relay capability no longer force auto approval, instead forwarding confirmation requests to the user WeChat permission confirmation: When tool execution requires permissions, a natural language confirmation request is sent via WeChat message, and the user can approve or reject by replying y/n WeChat Q&A support: The AskUserQuestion tool can send question options via WeChat, and users can select answers by replying with a number or free text WeChat plan confirmation: When ExitPlanMode is triggered, the plan summary is automatically read and presented to the user for confirmation via WeChat before execution begins 🐛 Bug Fixes WeChat Channel reply tool: Fixed an intermittent issue where the reply tool could not be found, eliminating race conditions during the connection process WeChat Q&A duplicate prompts: Fixed an issue where AskUserQuestion sent both a Q&A message and a permission confirmation message simultaneously WeChat Q&A parameter parsing: Fixed an issue where Q&A parameters in JSON string format were not parsed correctly"},{"id":"/cli/release-notes/v2.66.0","title":"🚀 CodeBuddy Code v2.66.0 Release","body":"🚀 CodeBuddy Code v2.66.0 Release ✨ New Features Thinking Mode Enabled by Default Thinking mode is now globally enabled by default, providing enhanced reasoning capabilities without manual configuration. Complex code analysis and multi step task processing are now more accurate. 🐛 Bug Fixes Token counter: Fixed the token counter in the bottom right corner always displaying 0 Status bar cost display: Fixed the status bar script receiving incorrect cost data Status bar initialization: Fixed the status bar potentially not rendering on first display Context percentage: Fixed inaccurate context usage percentage display when approaching the limit Memory leak: Fixed status bar manager subscriptions not being properly cleaned up"},{"id":"/cli/release-notes/v2.65.1","title":"🚀 CodeBuddy Code v2.65.1 Release","body":"🚀 CodeBuddy Code v2.65.1 Release 🐛 Bug Fixes Headless Mode Execution Stability Removed the fixed 60 second forced exit logic in headless mode to prevent long running CLI, SDK, or automation scripts from being prematurely terminated before task completion. Long running requests are no longer incorrectly interrupted by fixed timeouts Improved execution stability in non interactive invocation scenarios Better suited for continuous running or externally awaiting automation workflows"},{"id":"/cli/release-notes/v2.65.0","title":"🚀 CodeBuddy Code v2.65.0 Release","body":"🚀 CodeBuddy Code v2.65.0 Release ✨ New Features Channel Messaging Support receiving messages from external sources (such as WeCom bots, WeChat customer service, etc.) via the MCP protocol, enabling multi channel message aggregation and processing. The startup screen automatically displays the list of configured Channels Channel sourced messages are displayed in a user friendly format during conversations Security controls including sender whitelisting and permission relay are supported 🔧 Improvements Background task control in non interactive mode: Automatically disables background execution parameters in headless, SDK, and print modes to prevent unmanageable background tasks in non interactive environments 🐛 Bug Fixes Background task PTY leak: Fixed an issue where PTY file descriptors were not released when background tasks were terminated, preventing system resource exhaustion during prolonged operation"},{"id":"/cli/release-notes/v2.64.2","title":"🚀 CodeBuddy Code v2.64.2 Release","body":"🚀 CodeBuddy Code v2.64.2 Release 🔧 Improvements Simplified Login Flow: Removed intranet environment detection logic at startup. All login methods (including iOA) are now always displayed without waiting for network detection China Edition Model Ordering: Adjusted the display order of the glm 5.0 series in the China edition model list for a better selection experience 🐛 Bug Fixes Repeated Context Compression: Fixed an issue where compression was immediately re triggered after completion, preventing unnecessary repeated compression cycles and improving long conversation stability Session Persistence Error: Fixed an issue where externalized large tool results were incorrectly synced back into memory, causing the model to fail to understand tool outputs. Tool results are now correctly saved and read"},{"id":"/cli/release-notes/v2.64.1","title":"CodeBuddy Code v2.64.1","body":"CodeBuddy Code v2.64.1 Bug Fixes Terminal Split Screen Stability: Fixed an issue where split screen operations could unexpectedly reset the terminal. PTY sessions are now only destroyed when the user explicitly closes the panel Message Bubble Filtering: Fixed an issue where internal system tag content occasionally appeared in user message bubbles, ensuring a clean interface display"},{"id":"/cli/release-notes/v2.64.0","title":"CodeBuddy Code v2.64.0","body":"CodeBuddy Code v2.64.0 New Features Comprehensive Web UI Enhancements The Web UI receives a comprehensive upgrade, delivering a brand new user experience: Redesigned Interface: Redesigned sidebar navigation, status bar, and login page with a unified visual style and interaction experience Multiple Views: Added history sessions, task management, plugin management, and other views for better information organization Brand Loading Animation: New paw print brand loading animation replacing the generic spinner Terminal Improvements: Support for terminal title display, with automatic theme color refresh on theme switch Instance Management Enhancement: Optimized instance management panel layout and interaction Cross Session Switching: The command supports cross session switching, with Web UI synchronization Improvements Large Tool Result Externalization: When tool results exceed 50KB, they are automatically saved to disk with a summary retained in conversation history, preventing unbounded memory growth in long running sessions Agent Task Memory Cleanup: Periodically cleans up completed task records and expired team member session references, fixing memory leaks in long running scenarios Diagnostics Panel Enhancement: The panel now includes memory usage and task statistics for easier resource troubleshooting TLS Verification Skip: Fixed the issue where disabling TLS verification did not take effect in non proxy scenarios Sub Agent Tool Rename: Renamed the Task tool to Agent, with the name more accurately reflecting its functionality ACP Stream Optimization: Delayed POST stream closure mechanism to resolve notification loss in tunnel scenarios Gateway Security Prompt: Added risk warnings and network access configuration guidance Message Queue Fix: Preserve queue messages when canceling requests to avoid losing queued messages Token Usage Fix: Fixed inflated percentages after compression causing repeated compression Rewind Fix: Prioritize pre modification file state for rest"},{"id":"/cli/release-notes/v2.63.5","title":"🚀 CodeBuddy Code v2.63.5 Release","body":"🚀 CodeBuddy Code v2.63.5 Release 🔧 Improvements Telemetry Control: Support disabling telemetry data reporting via environment variable for enhanced privacy control flexibility Image Format Detection: Support detecting image MIME types via file magic bytes, enabling correct format identification even when the file extension does not match the actual content"},{"id":"/cli/release-notes/v2.63.4","title":"🚀 CodeBuddy Code v2.63.4 Release","body":"🚀 CodeBuddy Code v2.63.4 Release 🔧 Improvements SDK Scenario Stability: Disabled automatic CLI updates in SDK mode to prevent subsequent requests from returning instantly due to process restart, improving reliability for SDK integration scenarios Session Recovery Reliability: Fixed message consumption anomalies caused by incorrect cleanup of historical messages during session reinitialization, ensuring normal message processing after session recovery Subagent Progress Display Optimization: Changed token statistics in subagent and Team member progress from cumulative consumption to current context window size, providing a more intuitive view of real time context usage E2E Test Enhancement: Client automatically responds to AskUserQuestion, command name validation now supports Unicode characters"},{"id":"/cli/release-notes/v2.63.3","title":"🚀 CodeBuddy Code v2.63.3 Release","body":"🚀 CodeBuddy Code v2.63.3 Release 🔧 Improvements Subagent Context Compression Fix: Fixed the issue where subagents could not resume after context compression, ensuring stability for subagent execution in long conversation scenarios Context Compression Quality Improvement: Fixed the issue where internal tags might leak into summarized content during compression, improving the accuracy of compressed context"},{"id":"/cli/release-notes/v2.63.2","title":"🚀 CodeBuddy Code v2.63.2 Release","body":"🚀 CodeBuddy Code v2.63.2 Release 🔧 Improvements Timeout Retry Enhancement: First token timeout now supports up to 2 retries with linear delay (2s/4s), improving recovery success rate during network fluctuations Message Queue Processing: Fixed an issue where accumulated user messages in the queue could not be processed after timeout error handling, ensuring smooth conversation flow State Consistency: Fixed race conditions in state reset logic during error handling, ensuring correctness of retries and queue processing"},{"id":"/cli/release-notes/v2.63.1","title":"🚀 CodeBuddy Code v2.63.1 Release","body":"🚀 CodeBuddy Code v2.63.1 Release 🐛 Bug Fixes Malformed JSON Context Pollution Fix: Fixed an issue where retry prompt messages were not cleaned up in time when the AI model occasionally generated malformed tool call parameters. Previously, these prompt messages were repeatedly sent to the model in every subsequent conversation turn, causing context pollution and unnecessary token consumption. After the fix, retry prompts are automatically cleaned up in the next conversation turn, keeping the conversation context clean"},{"id":"/cli/release-notes/v2.63.0","title":"🚀 CodeBuddy Code v2.63.0 Release","body":"🚀 CodeBuddy Code v2.63.0 Release ✨ New Features Disable TLS Verification Support disabling TLS certificate verification for HTTPS requests via a product feature toggle. This is designed for private deployment environments using self signed certificates or internal CA certificates, allowing connections without additional system certificate configuration. 🔧 Improvements Plugin Marketplace Tracking: Added tracking events for plugin marketplace operations, supporting actions such as marketplace add/remove/refresh, plugin install/uninstall/enable/disable, to help optimize the plugin ecosystem experience Centrifugo Connection Strategy: Disabled Centrifugo auto connection in favor of on demand manual startup, reducing unnecessary network overhead Configuration Panel Cleanup: Removed deprecated Wecom configuration items from the /config panel for a cleaner interface 🐛 Bug Fixes Auto Retry Race Condition Fix: Fixed an issue where the event was emitted prematurely during network error auto retry, causing the parent task to incorrectly determine that the sub agent had failed Timeout Duration Optimization: Increased streaming timeout and first token timeout from 60 seconds to 120 seconds, reducing false disconnections in weak network environments Context Compression Stability: Fixed an issue where abort signal cascading during compression caused the session to freeze, improving reliability in long conversation scenarios"},{"id":"/cli/release-notes/v2.62.1","title":"🚀 CodeBuddy Code v2.62.1 Release","body":"🚀 CodeBuddy Code v2.62.1 Release 🔧 Improvements Context Compression Optimization: Refactored the compression summary injection mechanism so that compressed context is restored in a more structured way, improving context coherence in long conversations. Also raised the auto compression trigger threshold to reduce unnecessary compression interruptions. The compression process no longer mixes in system rules and memory content, ensuring more accurate summaries SDK Communication Stability: Fixed multiple stability issues in the SDK communication layer, including concurrent write interleaving, permission requests hanging after disconnection, and incomplete interrupt responses. The Python SDK enhanced JSON buffer fault tolerance, and the JS SDK improved backpressure handling WeCom Bot Interaction Experience: Replaced static text with streaming messages for processing status display, automatically replacing with final results upon completion for a cleaner chat history 📝 Documentation Updates WeCom Bot Documentation Navigation: Unified sidebar titles for related documentation and fixed duplicate entries in the Chinese version"},{"id":"/cli/release-notes/v2.62.0","title":"🚀 CodeBuddy Code v2.62.0 Release","body":"🚀 CodeBuddy Code v2.62.0 Release ✨ New Features Delegate Tool Support (Experimental) Added the DelegateTool, which allows Agents to invoke delegate tools registered by external clients (such as Web UI or IDE plugins) to enable UI querying and UI control capabilities. This provides more flexible extensibility for integrating CodeBuddy Code with external toolchains. 🔧 Improvements Remote Control Refactoring: Unified the command into a general purpose command, supporting unified management of multiple long lived connection clients, with a new interactive UI panel for quick client connection selection Fast Local Command Execution for Remote Control: Added a mechanism to quickly detect local commands, avoiding unnecessary waiting prompts for local commands like and Enhanced Model Compatibility: Added an OpenAI model adapter to automatically handle incompatible parameters; the Gemini adapter now includes JSON Schema field cleanup, fixing 400 errors caused by tool parameters Stream Timeout Optimization: Adjusted the default stream timeout from 30 seconds to 60 seconds, with new smart detection to prevent completed responses from being incorrectly identified as timed out Bash Tool Description Optimization: Provided clearer description examples for complex commands and refined the dangerous command list Memory Path Structure: Aligned project memory directories to the standard path structure, fixing incomplete path display in menus 🐛 Bug Fixes ACP Session Management: Fixed an issue where newSession requests reused old sessions by default, switching to an explicit field to control session reuse behavior AbortController Leak: Unified usage of to prevent listener accumulation warnings during long sessions"},{"id":"/cli/release-notes/v2.61.3","title":"🚀 CodeBuddy Code v2.61.3 Release","body":"🚀 CodeBuddy Code v2.61.3 Release 🔧 Improvements Improved Startup Stability: Fixed startup failures caused by authentication initialization timeout and asynchronous initialization of the remote control service during CLI startup, improving cold start success rate Moonshot Model Compatibility: Optimized tool message content parsing logic to prevent plain string arrays (such as file path lists) from being incorrectly converted to content blocks, improving tool call stability for Moonshot models Plugin Update Mechanism Optimization: Switched to a fetch + reset strategy instead of pull, resolving plugin update failures when the local and remote branches of the plugin Git repository diverge SDK Interaction Fix: Fixed an issue where interactive tools (such as AskUserQuestion) were unexpectedly disabled in SDK mode, while ensuring interactive tools are properly disabled in Print mode Web Search Upgrade: Migrated to the new search API with optimized response parsing and error handling 🐛 Bug Fixes Third Party API Connection Fix: Fixed an issue where the Authorization header was incorrectly removed when connecting to third party APIs using mode, causing 401 errors. Also filters headers to avoid 400 errors"},{"id":"/cli/release-notes/v2.61.2","title":"🚀 CodeBuddy Code v2.61.2 Release","body":"🚀 CodeBuddy Code v2.61.2 Release 🔧 Improvements WeCom AI Bot WebSocket Compatibility: Migrated WebSocket implementation to the W3C standard API, supporting both Bun and Node.js runtimes for improved cross platform compatibility WeCom AI Bot Auto Connect: Added startup parameter to automatically connect to WeCom AI Bot on launch, eliminating the need to manually run the command"},{"id":"/cli/release-notes/v2.61.1","title":"🚀 CodeBuddy Code v2.61.1 Release","body":"🚀 CodeBuddy Code v2.61.1 Release 🔧 Improvements SDK Version Update: Upgraded Agent SDK JS to 0.3.81, keeping the SDK in sync with the CLI version"},{"id":"/cli/release-notes/v2.61.0","title":"🚀 CodeBuddy Code v2.61.0 Release","body":"🚀 CodeBuddy Code v2.61.0 Release ✨ New Features Memory System Overhaul Shortcut for Saving Memories: The shortcut now saves memories to , with support for selecting either Project or User scope, providing more flexible management of personal and project level preferences. Auto Memory Independent Control: A new management panel has been added, supporting independent toggling of Auto Memory. It can also be switched via the panel. Typed Memory (Experimental): Supports 4 structured memory types ( / / / ) and YAML frontmatter format for more organized memory management. /memory Command with Arguments: Supports saving memories directly via command arguments, without needing to navigate to the management page. 🔧 Improvements Decoupled Tool Search and Execution: ToolSearch now returns the full parameter schema for the agent to execute, keeping the context prefix stable to improve KV cache hit rates. Context Management Optimization: Lowered the token usage warning threshold so context compression triggers earlier, reducing degradation in conversation quality caused by excessively long contexts. Shell Performance Optimization: Optimized the PTY fd leak detection mechanism to avoid blocking the event loop. WeCom Bot Timeout Fix: Adopted a two phase reply mechanism to avoid the 30s streaming timeout issue, allowing long running Agent tasks to return results correctly. Web UI Session Sync: When is executed or a new conversation is created in the Web UI, the CLI terminal view refreshes in sync. File Path Completion: The Web UI input box now supports triggered file path completion, automatically adding a space after selection. Prompt Suggestions: The Web UI now displays prompt suggestions generated on the CLI side; press Tab to quickly accept them. 🐛 Bug Fixes Tool Call Retry: Fixed an issue where invalid JSON parameters returned by the model caused an immediate 400 error. The model is now informed of the specific JSON parse error and retries automatically. Sub agent Hook Isola"},{"id":"/cli/release-notes/v2.60.0","title":"🚀 CodeBuddy Code v2.60.0 Release","body":"🚀 CodeBuddy Code v2.60.0 Release ✨ New Features WeCom Bot Remote Control Supports remotely controlling CodeBuddy Agent via WeCom AI Bot persistent connection — no public IP required. Use the command to quickly connect. The remote control module has also been refactored into an extensible multi client registration architecture, making it easier to integrate additional IM platforms in the future. 🔧 Improvements Custom Model Auth Error Optimization: When a custom model returns a 401 error, automatic logout is no longer triggered. A targeted API Key check prompt is provided instead. When the specified model does not exist, the list of models available under the current account is automatically displayed. Resume Session Panel: The currently active session is highlighted in green with a checkmark, making it easy to identify at a glance. Web Slash Command Handling: Removed client side slash command interception — all command logic is now handled uniformly by the server. 🐛 Bug Fixes Image History Restoration: Fixed a timing issue with image blob reference tracking to ensure correct deduplication of historical images, preventing unresolved blob references from being sent to the model. Nested Skills Loading: Fixed an issue where directories containing sub Skills could not be discovered and loaded. Also increased the scan depth limit to support deeper nested structures. Skip Internal Request Headers: Fixed an issue where the environment variable had no effect, ensuring internal request headers are correctly stripped when connecting to third party gateways. Tracing Initialization: Fixed a \"No API key provided for OpenAI tracing exporter\" error appearing in some users' terminals."},{"id":"/cli/release-notes/v2.59.0","title":"🚀 CodeBuddy Code v2.59.0 Release","body":"🚀 CodeBuddy Code v2.59.0 Release ✨ New Features Hook Driven Worktree Support Provides isolated workspace capability for non Git version control systems such as SVN and Perforce. Through the and Hook events, you can fully customize the creation and cleanup logic for worktrees, no longer limited to Git repositories: Even in a Git repository, if Hook is configured, the Hook based approach takes priority Hook based worktrees always display the keep/delete menu on exit, preventing errors in non Git projects caused by missing Git commands Worktree Base Branch Specification The parameter now supports using to specify the base branch: Supports both remote branches ( ) and local branches ( ) Automatically falls back to the remote default branch with a warning when the specified branch does not exist, without interrupting the startup process The tool now supports the parameter as well 🔧 Improvements Plan Mode Approval: Fixed an issue where the ExitPlanMode tool could not correctly display plan content when approving in the Web UI. Users can now see the complete plan content and permission request list in the approval dialog Image Read Deduplication: Fixed an issue where an image at the same path was incorrectly deduplicated after being modified. The system now correctly detects file updates and returns the latest image content Worktree Hook Compatibility: Completed the SDK protocol and documentation for and , ensuring custom worktree hooks receive full context and can integrate stably 🐛 Bug Fixes ACP Connection Cleanup: Fixed an issue where old connections were not properly cleaned up when starting a new chat, causing broadcast messages to be rendered multiple times"},{"id":"/cli/release-notes/v2.58.0","title":"🚀 CodeBuddy Code v2.58.0 Release","body":"🚀 CodeBuddy Code v2.58.0 Release ✨ New Features WeChat KF & WeCom Remote Gateway Added support for WeChat KF (WeChat Customer Service) and WeCom (Enterprise WeChat) platform integrations. Supports receiving messages and sending replies via Webhook callbacks. The WeChat KF adapter includes full capabilities: callback signature verification, AES encryption/decryption, syncmsg message polling, and automatic customer service account creation. 🔧 Improvements Python SDK Authentication Enhancement: Added standalone authentication APIs ( / ), supporting two phase login flow; refactored control request mechanism to support request response matching and timeout handling Python SDK Type Improvements: Added type definitions for , , , and more SDK Error Diagnostics: Python SDK added startup crash detection and stderr capture; JS SDK improved process exit reason tracking and error type exports Headless Mode Stability: Refactored module exports to a three layer structure, eliminating IoC resolution failures in headless builds Tunnel Connection Optimization: Forced HTTP/2 over QUIC for better compatibility; support for detached cloudflared process reuse across sessions; added tunnel state.json to manage concurrent multi port tunnels Plugin Marketplace Auto Update: Added enable/disable auto update toggle on marketplace detail pages; built in marketplace defaults to enabled, third party marketplaces default to disabled Config Cache Isolation: Fixed an issue where temporary CLI parameters (e.g., ) would pollute the configuration cache Web UI Improvements: History playback now displays images in user messages with zoom in support; sub agents support collapse/expand; tool calls are uniformly clickable Web UI Bun SFE Compatibility: Support for embedding static files into Bun single file executables, compatible with resource loading in flat mode Gateway Command Experience: Added loading animation when starting the Gateway service to prevent repeated user actions Task Progress Display: O"},{"id":"/cli/release-notes/v2.57.1","title":"🚀 CodeBuddy Code v2.57.1 Release","body":"🚀 CodeBuddy Code v2.57.1 Release 🔧 Improvements Headless Mode Scheduled Task Support Headless mode now includes the export of scheduled task capabilities. In scripts, SDK, and server side integration scenarios, you can use scheduled task features more directly, reducing the need for additional wrappers and integration overhead. Supports direct access to scheduled task capabilities in headless integration scenarios Brings feature parity between scripts, SDK, and the interactive CLI"},{"id":"/cli/release-notes/v2.57.0","title":"🚀 CodeBuddy Code v2.57.0 Release","body":"🚀 CodeBuddy Code v2.57.0 Release ✨ New Features Remote Gateway (Beta) A brand new remote control feature that allows you to remotely access your CodeBuddy Code CLI session from any device via Cloudflare Tunnel. It comes with a full featured Web UI, including: Remote terminal panel with split screen layout and real time WebSocket communication Interactive Q&A panel for answering Agent questions directly from the Web UI Visual display of conversation compression and Team progress Secure authentication and multi client synchronization Scheduled Tasks Create scheduled tasks to let CodeBuddy automatically perform repetitive work on a set schedule. Simply define execution intervals using cron expressions, with support for viewing and canceling created tasks. 🔧 Improvements Hook Output Collapse Configuration: Added the setting, which can be configured via the panel to control whether Hook output is collapsed by default First Token Timeout Detection Optimization: Now detects meaningful model output instead of raw responses, preventing server heartbeats from invalidating timeout detection, with enhanced retry mechanism stability Sub agent MCP Inheritance: Sub agents can now correctly use MCP server tools configured by the parent agent Fish Shell Keyboard Compatibility: Fixed unresponsive key input in Fish shell 3.4+ when used with terminals supporting the Kitty keyboard protocol Tool Search Parameter Optimization: Enhanced parameter descriptions to provide better usage guidance 🐛 Bug Fixes API Error Response Handling: Fixed an issue where the UI would freeze when the API returned errors (e.g., rate limiting) MCP OAuth Authentication: Fixed OAuth Provider cache lookup failures to ensure a stable and reliable authentication flow Memory Leak Warning: Fixed MaxListenersExceededWarning caused by abort listeners exceeding the limit during long running sessions Streaming Output Format: Fixed formatting and completeness issues with JSON output Hooks Chinese Encoding: Fixed garble"},{"id":"/cli/release-notes/v2.56.1","title":"🚀 CodeBuddy Code v2.56.1 Release","body":"🚀 CodeBuddy Code v2.56.1 Release 🐛 Bug Fixes Conversation Compression Display: Fixed the completion detection logic for compressed conversation groups by checking for the presence of an assistant reply instead of a fixed message count, preventing abnormal compression state display in edge cases"},{"id":"/cli/release-notes/v2.56.0","title":"🚀 CodeBuddy Code v2.56.0 Release","body":"🚀 CodeBuddy Code v2.56.0 Release ✨ New Features Worktree PR Support Support for creating worktrees from CNB (Code Nebula Buddy) platform PR links, including domains such as cnb.woa.com and cnb.cool. Within a worktree, you can directly perform code review and modifications based on a PR. 🔧 Improvements New GPT 5.4 model: Supports 272K input, 128K output, with reasoning and image capabilities MCP panel optimization: Removed borders, grouped server list by configuration source, added diagnostic information display for a cleaner and more intuitive interface Model compatibility layer: Added a model compatibility handler that automatically adapts API request format differences for third party models such as Gemini and Moonshot, reducing manual configuration Error diagnostics enhancement: Improved error logging for model requests and SDK Transport, supporting streaming error response body reading and process close reason capture for easier troubleshooting Tool search optimization: Split search and activate operations into separate parameters for clearer invocation; unmatched tool names now automatically fall back to fuzzy search User query identification: Added tag wrapping for user messages to help models more accurately distinguish actual user queries from system context content 📝 Documentation Updates MCP environment variable expansion documentation: Added documentation for environment variable expansion usage, including syntax descriptions, supported configuration fields, examples, and common use cases"},{"id":"/cli/release-notes/v2.55.1","title":"🚀 CodeBuddy Code v2.55.1 Release","body":"🚀 CodeBuddy Code v2.55.1 Release 🔧 Improvements MCP environment variable defaults: MCP configuration now supports the syntax, automatically using the specified default value when an environment variable is not set, simplifying MCP server configuration Worktree initialization improvements: Enhanced symlink creation logic with automatic file/directory type detection and conflict handling; improved file processing for better performance in large repositories Hooks Windows path compatibility: Fixed path parsing issues when executing hooks via Git Bash on Windows where backslashes caused failures, now uniformly converting to Unix style paths 🐛 Bug Fixes SDK authentication fix: Fixed an issue where the authentication URL was incorrectly overwritten during login Environment configuration protection: Fixed an issue where network environment settings explicitly configured by users via or were automatically overridden SessionStart hook race condition fix: Fixed an issue where the first message could be processed before the SessionStart hook completed, causing injected context to be lost"},{"id":"/cli/release-notes/v2.55.0","title":"🚀 CodeBuddy Code v2.55.0 Release","body":"🚀 CodeBuddy Code v2.55.0 Release ✨ New Features Git Worktree Support The new Worktree feature allows you to develop in parallel across isolated working directories without interference: Use the flag to launch an isolated development environment for safe experimental changes Combine with the flag to run in a dedicated tmux session, ideal for long running tasks Agents can dynamically create and enter worktrees during a session via the EnterWorktree tool Sub agent tasks automatically inherit the worktree working directory, ensuring correct file operation paths Supports and event hooks for custom VCS integration Automatically detects changes on exit and provides clear action options; worktrees with no changes are cleaned up automatically 🔧 Improvements Tool search optimization: ToolSearch now supports both search and activate modes — search mode displays activated tools and candidates in a layered view, while activate mode enables precise activation by name Status bar line wrapping: Long text in the status bar now wraps automatically instead of being truncated Diff wide character handling: Fixed inaccurate line wrapping in the Diff view when content contains wide characters such as Chinese text or Emoji Message identification optimization: Improved user message identification logic to exclude teammate messages automatically sent by the framework"},{"id":"/cli/release-notes/v2.54.0","title":"🚀 CodeBuddy Code v2.54.0 Release","body":"🚀 CodeBuddy Code v2.54.0 Release ✨ New Features Skills Nested Subdirectories Skills can now be organized using subdirectories within the directory. Nested Skills automatically generate colon delimited qualified names (e.g., ), and short name matching is also supported, making Skills management more flexible and organized. 🔧 Improvements Startup optimization: Eliminated redundant execution during PromptContext initialization; concurrent requests now reuse the same initialization result, improving startup speed Model selection optimization: Improved model selection mechanism across different agent modes, enhancing configuration flexibility MCP config environment variable expansion: placeholders in MCP server configurations are now automatically replaced with the corresponding environment variable values. Supports command/args/env for stdio and url/headers for SSE/HTTP transports. Missing variables are left as is with a diagnostic message generated Context compaction stability: Fixed an issue where message enqueuing during automatic compaction prevented compaction from executing, and improved robustness of interrupt waiting. Also fixed internal continuation messages displaying incorrectly in the chat UI during compaction Vim word motion enhancement: Word motions (w/b/e) in Vim mode and keybindings now correctly support CJK characters, treating each CJK character as an individual word Gzip compression optimization: Gzip compression is now automatically skipped when a custom API endpoint is configured or when a model uses a custom URL, preventing request failures caused by third party services that do not support gzip Hook output encoding fix: Fixed garbled error messages from Hook scripts on Chinese Windows systems /skills panel enhancement: The Skills panel now also displays custom slash commands, with group headers showing the source directory path. Token counting now only includes the description portion, avoiding misconceptions about context usage Truncation retry"},{"id":"/cli/release-notes/v2.53.0","title":"🚀 CodeBuddy Code v2.53.0 Release","body":"🚀 CodeBuddy Code v2.53.0 Release ✨ New Features WeCom Remote Control Support remote control of CLI via WeCom (WeChat Work), enabling task dispatching and result pushing from mobile devices. Manage your development tasks anytime, anywhere from your phone, no longer limited to operating in front of a terminal. 🔧 Improvements MCP Dynamic Tool Updates: Support notifications from MCP servers, automatically refreshing the tool list when changes occur without requiring a restart or manual reconnection Reasoning Effort Configuration: Added a Reasoning Effort setting in the /config panel, supporting five levels: auto/low/medium/high/xhigh, to customize model reasoning depth Status Bar Enhancement: Added session name, permission mode, context window usage, and other fields with multi line rendering support and style optimizations LSP Server Lazy Loading: LSP servers now use lazy loading by default, starting only on first use to reduce resource consumption at startup Error Tracking Enhancement: WebSearch and ImageGen tools now include requestId in error messages when API calls fail, making it easier to diagnose issues Non Interactive Mode Optimization: Improved prompt messages when tool permissions are denied in print mode, providing clear bypass instructions File Auto Completion Refresh: Fixed an issue where newly added files were not suggested when typing ; the file list cache now automatically refreshes after expiration Skill Tool Result Optimization: Improved result message formatting after Skill and slash command execution for clearer output Hook Input Processor: Added extension point to support injecting context fields before Hook execution ACP Error Handling: Improved error message transmission in ACP mode, allowing clients to receive more detailed error status codes 🐛 Bug Fixes Conversation History Restoration: Fixed an issue where context before compaction was lost when resuming a session after executing compact Team Abort Signal Isolation: Sub agents no longer lis"},{"id":"/cli/release-notes/v2.52.6","title":"🚀 CodeBuddy Code v2.52.6 Release","body":"🚀 CodeBuddy Code v2.52.6 Release 🔧 Improvements Model Request Logging Enhancement: Added comprehensive request lifecycle logging, covering key events including request sending, first token arrival, streaming progress, completion/error/timeout, enabling quick issue identification via requestId and agent name Runtime Warning Elimination: Fixed the MaxListenersExceededWarning that appeared during long conversations by implementing a unified abort controller management utility, improving stability in long sessions Hook Message Rendering Enhancement: Hook messages now display different icons and colors based on execution status (success/blocked/warning/error), with support for expanding/collapsing to view detailed content, improving readability"},{"id":"/cli/release-notes/v2.52.5","title":"🚀 CodeBuddy Code v2.52.5 Release","body":"🚀 CodeBuddy Code v2.52.5 Release 🔧 Improvements Image History Optimization Image data in conversation history is now deduplicated and stored via BlobStore. Only the most recent N turns retain full image data, while earlier turns are automatically replaced with text placeholders, significantly reducing context token consumption. When the same image is read multiple times within the same conversation turn, a reference prompt is returned instead of resending the full data. Theme System Refactoring Expanded the theme color system to support semantic colors (such as success, warning, error, info, etc.) with enhanced terminal color compatibility. Added ChalkFactory for intelligent terminal capability detection, automatic color level adaptation, and support for color blind friendly themes. Gzip Compression Compatibility Fix: Fixed an issue where request bodies were incorrectly compressed during enterprise address login; gzip compression is now only enabled in SaaS and iOA environments Custom Model URL Handling: Automatically appends the suffix to custom model URLs, so users no longer need to manually construct the full path Bash Timeout Configuration: Supports dynamic configuration of the Bash tool timeout via settings env 🐛 Bug Fixes Hooks Command Execution: Fixed an issue where hook commands containing quotes, such as , failed to execute Logout Race Condition Fix: Fixed an issue where async operations were not terminated in time during logout, causing the session to be written back Conversation Compression Identifier Correction: Fixed an issue where the conversation identity was misidentified after async context compression, ensuring compressed messages are correctly attributed to the main conversation"},{"id":"/cli/release-notes/v2.52.4","title":"🚀 CodeBuddy Code v2.52.4 Release","body":"🚀 CodeBuddy Code v2.52.4 Release 🔧 Improvements First Token Timeout Detection Added a timeout detection mechanism for the first response data after a request is sent. The connection is automatically disconnected and retried upon timeout, preventing prolonged unresponsive waits. The stream data monitoring interval has been reduced from 10 seconds to 1 second, improving the detection speed of abnormal connections. Custom timeout durations can be configured via the and environment variables. Request Compression Added support for gzip compression of API request bodies, reducing network bandwidth consumption and improving response speed on slow networks. CLI Subcommand Aliases: Added shorthand aliases for , , and ; added option for and macOS Code Signing: Fixed an issue on macOS 26+ where missing TeamIdentifier caused the system to terminate multiple running instances MCP Tool Hooks Fix: Resolved an issue where PreToolUse/PostToolUse hooks for MCP tools failed to trigger correctly Tool Call Truncation Retry: Optimized the retry mechanism for tool call parameters truncated due to model output exceeding limits, improving retry success rate Hook Permission Prompt Optimization: When a PreToolUse Hook returns an ask decision, the decision reason is now displayed as a warning in the permission confirmation dialog Paste Behavior Optimization: Pasting text content no longer automatically detects whether it is an image path and converts it; pasted text is always inserted as is Shell Configuration Unification: Removed support for PowerShell and CMD, requiring Windows users to use Git Bash Model Upgrade: Upgraded the Gemini Pro model from version 3.0 to version 3.1 🐛 Bug Fixes Input History Navigation: Fixed an issue where pressing the up arrow to browse history would stop scrolling after reaching an entry starting with Tool Permission Denial Rendering: Fixed an issue where tool calls could not be properly rendered in the UI when rejected by PreToolUse hooks or permission rules "},{"id":"/cli/release-notes/v2.52.3","title":"🚀 CodeBuddy Code v2.52.3 Release","body":"🚀 CodeBuddy Code v2.52.3 Release 🔧 Improvements Gemini Image Generation Models: Added three new image generation models — Gemini 3.0 Pro Image, Gemini 3.1 Flash Image, and Gemini 2.5 Flash Image — supporting both text to image and image to image generation Ctrl+D Exit Optimization: Ctrl+D now only triggers the double press exit flow when the input box is empty and there is no ongoing conversation, preventing accidental exits Windows Shell Compatibility: Fixed Shell path selection logic and shell snapshot functionality on Windows, ensuring Git Bash is preferred; improved configuration file detection and encoding handling; correctly identifies non POSIX shells such as fish and tcsh MCP Configuration Enhancement: The parameter now supports both file paths and direct JSON format; MCP servers with non project scope skip the approval check, reducing unnecessary confirmation prompts Dependency Upgrade: Upgraded OpenAI Agents SDK to 0.5.2 and OpenAI SDK to v6 🐛 Bug Fixes Plugin List Display: Fixed an issue where plugin skills failed to load correctly after cache clearing"},{"id":"/cli/release-notes/v2.52.2","title":"🚀 CodeBuddy Code v2.52.2 Release","body":"🚀 CodeBuddy Code v2.52.2 Release 🔧 Improvements Custom Token Authentication: Supports recognizing custom token authentication configuration from the ACCPRODUCTCONFIG environment variable; fixed an authentication fallback issue when the configuration was loaded but synchronization had not yet completed Session Loading Performance Optimization: The command now uses parallel reads when loading historical sessions, reducing wait time Plugin Loading Speedup: Parallelized the plugin loading process, improving startup speed by several times in multi plugin scenarios 🐛 Bug Fixes /doctor Command: Fixed an issue where a null session could cause a property access error SDK Python Build Script: Updated the goreleaser output directory path to match headless build artifact naming; removed unused imports"},{"id":"/cli/release-notes/v2.52.1","title":"🚀 CodeBuddy Code v2.52.1 Release","body":"🚀 CodeBuddy Code v2.52.1 Release 🔧 Improvements Startup & Stability Instant Version Query: / no longer triggers the full initialization process, significantly improving response speed Pipe Environment Compatibility: Subcommands no longer wait for stdin input in non TTY environments, preventing process hangs Authentication Timeout Protection: Authentication initialization automatically times out when the network is unreachable, preventing the CLI from waiting indefinitely Team Member Switching Experience Instant Switching: Use left/right arrow keys to instantly switch team member views without pressing Enter, making the operation smoother Quick Enter/Exit: Press the down arrow key to enter selection mode with @main selected by default; press the up arrow key or Esc to exit Input History Isolation: History navigation and member selection mode no longer interfere with each other; clearing the input box automatically exits history navigation SDK Improvements Python SDK MCP Server Simplification: Server objects can now be passed directly without manually constructing a dictionary JS SDK Executable Configuration: Custom CLI executable file paths and arguments are now supported via and Internal Request Header Filtering: Internal request headers can be cleaned up via the environment variable to avoid interfering with third party API gateways 🐛 Bug Fixes Skill Loading: Fixed an issue where Skills from plugins occasionally failed to load, ensuring correct initialization order Skill Invocation: Fixed an issue where Skills with could not be automatically invoked by the model Team Member Colors: Fixed duplicate color index assignment when generating Team members concurrently Sub agent Concurrency Stability: Fixed MaxListenersExceededWarning caused by a large number of concurrent sub agents"},{"id":"/cli/release-notes/v2.52.0","title":"🚀 CodeBuddy Code v2.52.0 Release","body":"🚀 CodeBuddy Code v2.52.0 Release ✨ New Features Team View Switching Quickly switch between different team member views using arrow keys. Press to enter switching mode, to select a member, and to confirm and switch to that member's view, allowing you to check conversation history and work progress in real time. The highlight preview and input box border color automatically sync when switching, keeping you informed of each member's work status at all times. Headless Mode Added a lightweight headless build (45% smaller in size), supporting , , and for quick startup, ideal for CI/CD pipelines and automation integration scenarios. 🔧 Improvements Major Startup Performance Boost: Optimized the startup flow, reducing Application.start() time by 96% and memory usage by 31%, delivering a much smoother startup experience Bun Native Optimization: Replaced third party dependencies (PTY, glob, semver, etc.) with Bun native APIs, improving runtime performance Dependency Reduction: Removed unused dependencies to reduce installation size Authentication Timing Fix: Ensured authentication completes before API calls, eliminating occasional 401 errors during cold starts Model Sorting Optimization: Adjusted default model priority order for the China edition, making commonly used models easier to select Command Execution Stability: Optimized command execution and environment initialization flow, reducing execution interruptions under abnormal conditions Authentication Experience Enhancement: Improved the robustness of the API Key Helper token acquisition process, enhancing authentication flow stability Error Handling Upgrade: Upgraded error handling from string matching to custom error classes, improving error identification reliability Stream Timeout Auto Retry: Automatically retries when model streaming responses time out, requiring no manual intervention. Supports customizing timeout duration via the environment variable Command Suggestion Filtering: Skills that cannot be invoked dir"},{"id":"/cli/release-notes/v2.51.2","title":"🚀 CodeBuddy Code v2.51.2 Release","body":"🚀 CodeBuddy Code v2.51.2 Release 🔧 Improvements New Model Support: Added Gemini 3.0 Pro and Gemini 3.0 Flash model configurations. You can now use these two latest generation Google models in the model selector, enjoying stronger reasoning capabilities and faster response speeds"},{"id":"/cli/release-notes/v2.51.1","title":"🚀 CodeBuddy Code v2.51.1 Release","body":"🚀 CodeBuddy Code v2.51.1 Release 🔧 Improvements Ctrl+N/P Key Mapping: Added support for Ctrl+N/Ctrl+P as alternatives to ↓/↑ arrow keys, working across all scenarios including input fields, selection menus, and confirmation panels, providing a smoother experience for users accustomed to Emacs keybindings Loading State Token Display Optimization: Fixed the issue where token count displayed as 0 while the main agent waited for a subagent; now correctly shows real time streaming token changes. Both subagent and Team member progress rows support real time streaming token display Session Level Permission Sync: When selecting \"Don't ask again for this session\" during sub agent execution, the permission is now synced to the main session and all sub agents, avoiding repeated permission confirmation prompts MCP Connection Timeout Protection: Added timeout mechanism for MCP server connection waits, preventing indefinite hangs in headless mode when a server is unresponsive Team Notification Optimization: Refactored background task completion notifications to use a mailbox based delayed deduplication mechanism, preventing duplicate notifications from interrupting conversation flow; fixed queue messages losing sender identity New Model Support: Added GPT 5.3 Codex model configuration Agent Teams Setting Display: Agent Teams default state in the settings panel now correctly displays as enabled 🐛 Bug Fixes Custom Commands Override Built in Commands: Fixed the issue where custom slash commands and Skills could not override built in commands with the same name; now correctly follows project level user level built in priority order Startup UI Rendering: Fixed welcome Banner duplicate rendering and the display issue where the trust dialog overlapped with Banner content Background Task Query: Fixed the \"not found\" error when querying via TaskOutput after a background Agent was launched"},{"id":"/cli/release-notes/v2.51.0","title":"🚀 CodeBuddy Code v2.51.0 Release","body":"🚀 CodeBuddy Code v2.51.0 Release 🎉 New Features Memory Directory Summary Added memory file list summary in the system prompt, displaying file names, sizes, modification dates, and first line titles. The AI assistant can now see at a glance which memory files you have and load relevant content on demand, avoiding stuffing all memory file contents into the context and significantly reducing Token consumption. Automatic Memory File Cleanup Memory files are now cleaned up alongside session history cleanup, reusing the same retention period configuration. No more worrying about the directory growing indefinitely. 🔧 Improvements Skills Support Inline Shell Commands: Skills' SKILL.md now supports ! syntax to execute Shell commands, maintaining a consistent processing pipeline with slash commands, making Skills authoring more flexible Skill Slash Command Dispatch: Support invoking registered Skills directly via or , with automatic fallback to Skill lookup when no built in command matches, improving command usage fluency Slash Command Menu Optimization: Descriptions are automatically truncated when too long, preventing menu items from spanning multiple lines for a cleaner interface YAML Parsing Enhancement: Support for folded block scalar syntax ( , ), correctly folding multi line descriptions into a single line Model Coefficient Update: Updated billing coefficients for all models to the latest values, added support for additional models, ensuring more accurate billing 🐛 Bug Fixes Confirmation Dialog Scroll Fix: Fixed an issue where the scrollbar would automatically jump to the top when permission confirmation dialogs, plan confirmation dialogs, and edit confirmation dialogs exceeded the terminal height, providing a smoother experience for confirming long content Custom Sub agent Tool Inheritance: Fixed an issue where custom sub agents would inherit the ability to create sub agents when no tool list was configured, preventing unintended recursive calls"},{"id":"/cli/release-notes/v2.50.7","title":"CodeBuddy Code v2.50.7 Release","body":"CodeBuddy Code v2.50.7 Release Improvements Team Member Focus Navigation When using Team collaboration, you can now navigate between members using Shift+Up/Down to switch views, viewing each member's conversation history, execution progress, and token consumption in real time. Press Ctrl+O to quickly return to the main view. Direct Member Messaging: After focusing on a member, the input box automatically switches to message sending mode for that member. Use @main to route messages back to the main agent Message Routing Enhancement: The SendMessage tool supports the \"main\" alias, and user message injection into member sessions no longer adds unnecessary XML wrapping Bug Fixes Sub agent AbortSignal Listener Leak: Fixed an issue where abort event listeners were registered and removed on the wrong AbortSignal in sub agents, eliminating error reports during cascading interrupts Member Session Recovery: Fixed subscription loss causing 0 tokens when sub agents restart, fixed race condition in agentend events"},{"id":"/cli/release-notes/v2.50.6","title":"CodeBuddy Code v2.50.6 Release","body":"CodeBuddy Code v2.50.6 Release Improvements High risk Command Detection Rules Optimization: Significantly reduced false positive rates, refined CRITICAL/HIGH/MEDIUM three tier risk assessment rules. Common development commands like , , , , etc. are no longer incorrectly blocked, improving daily development workflow Permission Rule Security Layering: Distinguished allow rules by source into trusted (user settings) and untrusted (project settings), preventing malicious repositories from injecting permission rules through project configuration files to bypass security checks, enhancing supply chain security protection Security Allowlist Expansion: Added 50+ common development tool commands to the security allowlist, covering build tools, testing frameworks, package managers, code quality tools, and more, reducing unnecessary authorization prompts Sub agent Model Configuration Optimization: Added relatedModels configuration for MiniMax M2.5 and Kimi K2.5 models, ensuring sub agents correctly select corresponding lightweight and reasoning model variants when using these models Bug Fixes Process Hang Fix: Fixed an issue where the process would not exit after terminal closure, causing 100% CPU usage Shell Handle Leak Fix: Fixed multiple Shell execution handles not being properly released, preventing PTY file descriptor leaks node pty fd Leak Fix: Detected and closed additional ptmx file descriptors leaked internally by node pty during dispose Diagnostics Enhancement: Added Active PTYs count to the /doctor panel for easier detection of potential PTY leaks"},{"id":"/cli/release-notes/v2.50.5","title":"CodeBuddy Code v2.50.5 Release","body":"CodeBuddy Code v2.50.5 Release New Features Bash Dedicated Sub agent Added a Bash built in sub agent focused on command line task execution. When the AI needs to perform git operations, run build tools, execute tests, or other terminal tasks, it automatically invokes a lightweight Bash sub agent for quick completion, improving command execution efficiency. Command Safety Detection Added Bash command injection detection mechanism that automatically identifies and blocks commands containing potentially dangerous constructs such as backtick substitution, command substitution, and newline injection, enhancing terminal operation security. Improvements Sub agent Tool Configuration Optimization: Adjusted the Plan sub agent toolset with new team collaboration tool support; streamlined the Explore sub agent tools, reducing unnecessary tool loading Sub agent Label Display Optimization: Unified sub agent names to use foreground color text display for a cleaner and more consistent visual appearance"},{"id":"/cli/release-notes/v2.50.4","title":"CodeBuddy Code v2.50.4 Release","body":"CodeBuddy Code v2.50.4 Release Improvements Background Task Experience Upgrade Background agents now automatically create lightweight teams and send results back via SendMessage, eliminating the need to manually poll with TaskOutput. Background tasks automatically notify the main agent upon completion, making the overall interaction smoother. UI progress display has also been unified, with background tasks integrated into TeammateProgressView for centralized display. Startup Performance Optimization: Optimized the initialization process during first launch, parallelized the registration flow, improving startup speed by approximately 10% Terminal Rendering Optimization: Unified all animation components to a single global clock driver, reducing terminal flickering caused by independent timers Message Rendering Fix: Fixed an issue where messages were not displayed after completion, requiring terminal resize to become visible Memory Leak Fix: Fixed an issue where caused the internal output buffer to accumulate indefinitely Task Cleanup Fix: Fixed an issue where failed subtasks were not properly cleaned up, leaving residual progress displays Bug Fixes Bash Tool Output Fix: Fixed an issue where occasional extra blank lines appeared below Bash tool execution results"},{"id":"/cli/release-notes/v2.50.3","title":"CodeBuddy Code v2.50.3 Release","body":"CodeBuddy Code v2.50.3 Release Bug Fixes Module Loading Compatibility Fix: Fixed an issue where failed to load modules in certain bundling environments due to being unavailable, improving runtime compatibility"},{"id":"/cli/release-notes/v2.50.2","title":"CodeBuddy Code v2.50.2 Release","body":"CodeBuddy Code v2.50.2 Release Improvements MCP Remote Transport Type: Added transport type support, allowing connection to MCP servers via remote HTTP, expanding MCP connectivity options Build Speed Improvement: Switched to the Rspack copy plugin and parallelized patch scripts to speed up project builds Task Progress Display Optimization: Completed subtasks are automatically cleared after all execution is finished, preventing accumulated completed entries from cluttering screen space and keeping the interface clean Bug Fixes Paste URL Misidentification Fix: Fixed an issue where pasting URLs starting with or were incorrectly identified as file paths"},{"id":"/cli/release-notes/v2.50.1","title":"CodeBuddy Code v2.50.1 Release","body":"CodeBuddy Code v2.50.1 Release Improvements Documentation Navigation Optimization: Moved the Agent Teams documentation to appear after Sub Agents, making the navigation structure better aligned with functional relevance and easier for users to browse in logical order Bug Fixes Config File Comment Preservation: Fixed an issue where JSONC comments under the mcpServers field were lost when saving MCP configuration, ensuring that comments added by users in configuration files are not accidentally deleted"},{"id":"/cli/release-notes/v2.50.0","title":"CodeBuddy Code v2.50.0 Release","body":"CodeBuddy Code v2.50.0 Release New Features Agent Teams Multi Agent Collaboration The new Team feature enables multiple Agents to work collaboratively, implementing task assignment and message passing through tools like TeamCreate, TeamDelete, and SendMessage. The Task tool extends support for teammate generation, and TaskList supports team task coordination, suitable for parallel processing scenarios in complex projects. Team functionality can be flexibly enabled or disabled via environment variables. Improvements Sub agent Task Display Optimization: Background tasks display real time progress in style, synchronous task progress is integrated into the loading spinner for a cleaner interface Task Completion Notification Enhancement: Notification messages include statistics such as execution duration, tool call count, and token usage for better understanding of task execution Background Task Resource Cleanup: Associated background shell tasks are automatically cleaned up when sub agents finish, preventing resource leaks TaskOutput Timeout Adjustment: Default timeout increased from 30s to 120s, defaults to blocking wait for completion, reducing timeout interruptions Lazy loaded Tool Fix: Fixed an issue where lazy loaded tools still reported \"Tool not found\" after being activated via search; now auto activates when not yet activated and prompts for retry Tool Search Results Optimization: Search results changed to concise text format, showing tool names and descriptions even when not expanded MCP Server Management Improvement: Fixed an issue where configuration was not actually deleted after removing an MCP server; SDK registered MCP servers now automatically connect during initialization and are immediately available SDK Parameter Format Standardization: CLI parameter formats for JS and Python SDKs standardized to style Plan Mode Interaction Optimization: Distinguishes between \"continue planning\" and \"exit plan mode\" operations when rejecting a plan, avoiding being tra"},{"id":"/cli/release-notes/v2.49.7","title":"CodeBuddy Code v2.49.7 Release","body":"CodeBuddy Code v2.49.7 Release New Features GLM 5.0 Model Support Added GLM 5.0 large language model with 200K context window and 48K output tokens, providing a more powerful reasoning capability option for domestic and iOA edition users."},{"id":"/cli/release-notes/v2.49.6","title":"CodeBuddy Code v2.49.6 Release","body":"CodeBuddy Code v2.49.6 Release Improvements SDK MCP Initialization Timing Optimization: Fixed a race condition between MCP server registration and prompt processing in SDK mode, ensuring MCP tools are ready before prompt processing to avoid tool call failures Headless Mode Detection Improvement: Optimized headless mode identification logic to support automatic detection for ACP mode and non TTY environments MCP Configuration File Path Support: The SDK's mcpServers parameter now supports file path string format, simplifying configuration ACP SDK Upgrade: Upgraded ACP SDK to version 0.14.1, fixing terminal output byte limit parameter type compatibility issues CI Configuration Optimization: Added npcName parameter support for bot configuration"},{"id":"/cli/release-notes/v2.49.5","title":"CodeBuddy Code v2.49.5 Release","body":"CodeBuddy Code v2.49.5 Release Improvements MCP Server Readiness Detection: Fixed an issue where MCP tools might not be ready during initialization in SDK mode, ensuring tools are fully initialized before the first invocation Build Optimization: Removed no longer needed build flags from Bun compilation, simplifying the binary packaging process Bug Fixes Session Compression Hang Fix: Fixed an issue where ACP sessions could permanently hang after compressing message logs; added timeout protection mechanism to prevent permanent blocking in abnormal conditions Session History Restoration: Fixed an issue where custom message items were not correctly skipped when finding the last message ID, avoiding incorrect message positioning when restoring sessions"},{"id":"/cli/release-notes/v2.49.3","title":"CodeBuddy Code v2.49.3 Release","body":"CodeBuddy Code v2.49.3 Release Improvements Model Error Prompt Enhancement: When a model is unavailable, automatically displays the list of models supported by the current account, making it easy for users to quickly switch to an available model Error Handling: Optimized the handling logic for wrapped ModelBehaviorError, ensuring that tool call failures are correctly identified and retried MCP Server Readiness Detection: Fixed an issue where MCP tools might not be ready during initialization in SDK mode"},{"id":"/cli/release-notes/v2.49.2","title":"CodeBuddy Code v2.49.2 Release","body":"CodeBuddy Code v2.49.2 Release Improvements Cross Session Task List Sharing Support sharing task lists across different sessions via the environment variable, facilitating multi terminal collaboration and continuous task tracking. Example: Date Format Enhancement Date display in system information now includes day of week information using a more user friendly format, improving readability. For example: . Bug Fixes Session Switch Permission Persistence Fixed an issue where the permission mode was not preserved when switching sessions, ensuring the current permission settings are maintained after switching. Previously, the permission mode would unexpectedly reset after switching sessions; now it is correctly retained. Interceptor Retry Mechanism Fixed an issue where the view layer still output the original failed result when the model response interceptor triggered an automatic retry. Now when the interceptor initiates a retry, it correctly suppresses the failed result output and only displays the successful response after retry. ACP Streaming Mode Interruption Optimization Interruption State Race Condition: Fixed a race condition in ACP streaming mode where the interruption state was modified by subsequent runs due to shared RunState; now uses event snapshot caching for interruption state Result Message Lookup: Improved final assistant message lookup logic to support reverse searching for completed messages from response output, with fallback to session history when not found Build Optimization Build Tool Upgrades: Upgraded goreleaser, bun, and uv to latest versions Bun Compilation Optimization: Enabled bytecode compilation and ESM format to improve startup performance"},{"id":"/cli/release-notes/v2.49.1","title":"CodeBuddy Code v2.49.1 Release","body":"CodeBuddy Code v2.49.1 Release Security Hardening Sandbox Configuration File Protection: Automatically prohibits writing to CodeBuddy configuration files (settings.json) in sandbox mode, preventing sandbox escape attacks through hook injection; file system denial rules are synchronously applied to Write, Edit, and other file operation tools to ensure comprehensive security policy consistency Improvements Session List Filtering: Filters out sub agent and compressed branch sessions, ensuring the session list and recent sessions only display actual user sessions SDK Documentation Fix: Fixed bracket formatting issues in authentication configuration links Bug Fixes Session History Navigation: Fixed an issue where switching sessions or restoring history could cause to incorrectly point to custom messages without IDs (such as summaries or topics), leading to conversation chain breakage"},{"id":"/cli/release-notes/v2.49.0","title":"CodeBuddy Code v2.49.0 Release","body":"CodeBuddy Code v2.49.0 Release New Features Usage Insights Report Added the command to generate AI driven usage insight analysis reports. Reports cover multiple dimensions including interaction style, project domain, friction points, highlights, and improvement suggestions, helping you better understand and optimize your AI collaboration patterns. Supports viewing HTML formatted visual reports in the browser. Improvements Statistics Accuracy: Optimized token usage statistics logic to correctly distinguish between main session and sub agent sessions; fixed token omission in tool calls Progress Display: Supports custom progress text, showing real time processing progress in loading state Custom Model Configuration: Fixed the issue where custom models incorrectly inherited global associated model configurations, ensuring behavior matches expectations Memory System: Optimized memory context prompts, streamlined wording, and added implicit memory source support to improve cross session memory recall Multi language Support Enhancement: All sub agents now correctly follow the user's language settings when responding UI Refresh Optimization: Optimized terminal refresh strategy after tool execution completion, added debounce mechanism to reduce unnecessary rendering Memory Optimization: Automatically releases session history and references after sub agent tasks complete, reducing memory usage Grep Search: Automatically corrects search pattern parameters to avoid unnecessary call failures; compatible with ripgrep regex syntax File Reading: Returns directory listing when reading a directory, helping quickly locate target files Bug Fixes Tool Error Handling: Improved error messages and handling logic when tools are not found Headless Mode: Fixed the issue where streaming output blocked when using non default agents, ensuring completion signals are correctly sent Tool Result Display: Fixed the issue where output from Edit and other tools was not displayed after execution, requir"},{"id":"/cli/release-notes/v2.48.1","title":"CodeBuddy Code v2.48.1 Release","body":"CodeBuddy Code v2.48.1 Release Improvements Environment Variable Authentication Conflict Detection: When or environment variables are set, the /login command automatically detects and suggests conflict resolution; authentication failures display more detailed diagnostic information to help quickly locate issues Sub agent Message Identification: Fixed the issue where sub agent user messages were missing parent tool identifiers during streaming output; clients can now correctly distinguish between main agent and sub agent messages MCP Prompt Command Format Unification: Unified the context concatenation format between MCP prompts and slash commands, ensuring the model correctly understands command sources and parameters Documentation Updates Prompt Hooks Documentation: Improved documentation for prompt based Hooks feature, added supported event descriptions, configuration examples, and best practice guides"},{"id":"/cli/release-notes/v2.48.0","title":"🚀 CodeBuddy Code v2.48.0 Release","body":"🚀 CodeBuddy Code v2.48.0 Release ✨ New Features Image to Image Tool (ImageEdit) New tool for AI based editing and modification of existing images: Supports style transformation, element addition, color modification, and other image editing operations Use command to switch to image to image model Configure the default model via environment variable or setting Prompt Hook New LLM based Hook type that supports defining trigger conditions using natural language for more flexible workflow control. 🔧 Improvements Image API Refactoring: Extracted shared module to unify API call logic for text to image and image to image Model Tag System: Introduced and model tags, allowing the same model to have multiple image generation capabilities Hook Configuration Panel: Support for displaying and managing Prompt Hooks with optimized blocking message display Token Calculation Accuracy: command now only counts actually enabled tools, excluding disabled built in tools and MCP tools Plan Mode Permission Inheritance: Plan mode now preserves permission settings from before entering, supporting combinations like \"plan + bypass\", with subagents also inheriting this permission configuration Hot Reload Optimization: Automatically detects and optimizes hot reload behavior in container environments with low FD limits, supports to completely disable hot reload Windows Path Hints: Added forward slash usage hints on Windows platform to avoid path parsing errors caused by backslashes WorkBuddy Configuration Separation: WorkBuddy now uses an independent configuration directory, separated from CLI's 🐛 Bug Fixes ACP Cancellation Handling: Optimized event delivery mechanism for cancel requests, ensuring sessions can correctly respond to cancellation operations MCP Non Interactive Mode: Fixed issue where MCP tools were not correctly identified as non interactive mode in ACP mode Memory Context Injection: Fixed missing system tags when injecting memory prompts Directory Scanning: Fixed incorrect relati"},{"id":"/cli/release-notes/v2.47.0","title":"🚀 CodeBuddy Code v2.47.0 Release","body":"🚀 CodeBuddy Code v2.47.0 Release ✨ New Features Cross session Memory New experimental memory feature that supports persistent memory across Agent sessions. You can enable this feature through the settings panel or the configuration. Team memory mode is also supported, storing memories in the project directory for team sharing. 🔧 Improvements command:// URI handling: Optimized command:// resource link handling in ACP protocol, correctly converting to slash command format and echoing original content blocks Command push filtering: Fixed issue where built in commands were incorrectly pushed to IDE, now only pushing user defined commands, skills, and specific built in commands File path search: Optimized matching precision for duplicate character queries to avoid mismatching scattered characters SSH remote clipboard: Fixed Ctrl+Y copy to clipboard failure in Linux + SSH remote environments by implementing OSC 52 protocol support for remote terminal clipboard operations Session resume history control: Optimized history replay logic when SDK resumes sessions, using signal to let CLI intelligently determine whether to replay history messages, improving the resume experience 🐛 Bug Fixes Pipe input: Fixed issue where content could not be read when using pipe input (e.g., ) Stop Hooks timing: Fixed issue where Stop Hooks were incorrectly executed when tools required user confirmation, now only triggered when there are no pending approval tools"},{"id":"/cli/release-notes/v2.46.0","title":"🚀 CodeBuddy Code v2.46.0 Release","body":"🚀 CodeBuddy Code v2.46.0 Release ✨ New Features Language Settings Added Language option in , allowing you to set your preferred response language. CodeBuddy Code will respond in your specified language, making communication more natural and smooth. 🔧 Improvements Copy Shortcut: Added Ctrl+Y shortcut to quickly copy the last AI response to clipboard, making it convenient to grab code snippets or important information Shell Command Execution Optimization: Optimized command execution mechanism to only use eval wrapper when additional environment configuration needs to be loaded, maintaining original behavior by default and improving command execution stability"},{"id":"/cli/release-notes/v2.45.1","title":"🚀 CodeBuddy Code v2.45.1 Release","body":"🚀 CodeBuddy Code v2.45.1 Release 🔧 Improvements Login UI Optimization: Adjusted login method order, moving iOA login to the last position with a note indicating it's only for Tencent internal employees, making it easier for new users to find the appropriate login method Documentation Enhancement: Added detailed explanations of four login methods in the quickstart documentation to help users understand the applicable scenarios for each login method SDK Version Update: Synchronized SDK JS to 0.3.40 and SDK Python to 0.3.38"},{"id":"/cli/release-notes/v2.45.0","title":"🚀 CodeBuddy Code v2.45.0 Release","body":"🚀 CodeBuddy Code v2.45.0 Release ✨ New Features Tool Search and Lazy Loading Added the ToolSearch tool, supporting natural language search for available tools. MCP servers now support configuration, deferring tool loading until needed, effectively reducing context consumption and improving tool selection accuracy. Environment Variable Model Configuration Support flexible model configuration through environment variables, convenient for use in CI/CD environments and scripts: : Override default agent model : Configure lite variant model : Configure reasoning variant model : Configure sub agent model : Enable extended thinking and set token budget SDK Commands Subscription SDK adds and methods, supporting retrieval and real time subscription to CLI available command list changes. 🔧 Improvements Skill Fork Context: Support configuration, allowing Skills to execute in an independent sub agent context Agent Type Specification: Added field to specify the sub agent type for executing Skills Image Paste Optimization: Added clipboard read retry mechanism, expanded macOS image format detection, supporting more screenshot tools Error Recovery Enhancement: When the model returns an invalid tool name, the system will prompt the model to check and retry Interface Simplification: Simplified \"Plan Mode\" to \"Plan\" for a cleaner interface 🐛 Bug Fixes ACP Multi turn Conversation: Fixed issue where second round prompts returned results directly, missing sessionUpdate events Plugin Loading Deduplication: Fixed issue where plugin skills, agents, and commands were duplicated in menus"},{"id":"/cli/release-notes/v2.44.1","title":"🚀 CodeBuddy Code v2.44.1 Release","body":"🚀 CodeBuddy Code v2.44.1 Release 🔧 Improvements Skill/Command Invocation Control: Added configuration option, allowing skills or commands to be set to manual trigger only mode, preventing automatic invocation by the model for more precise control over AI behavior Subagent Interruption Handling: Optimized behavior when Task subagents are interrupted by users, now returning clear interruption prompts and resumable Agent IDs, supporting task continuation via the parameter interruptions no longer mean lost progress Plan Subagent Enhancement: Plan subagents can now use Write, Edit, and MultiEdit tools to edit plan files, making plan mode more flexible and practical Media Content Error Auto Recovery: When requests fail due to oversized images, invalid formats, or too many images, the system automatically removes problematic content and provides compression suggestions, allowing conversations to continue WebFetch Tool Enhancement: Enhanced support for SPA pages, automatically extracting meta tag information when main page content is empty for better understanding of modern web applications Custom Headers Merge Optimization: Fixed case sensitivity issues when merging HTTP headers, now correctly overrides headers with the same name but different casing allowed tools Format Support: The field in custom Skills and Commands now supports both comma separated strings and YAML arrays for more flexible configuration Input Box Optimization: Fixed message sending timing issues, ensuring the input is cleared only after the message is fully sent 🐛 Bug Fixes Custom Request Header Parsing: Fixed newline character detection logic to ensure multi line header configurations are parsed correctly Documentation Links: Corrected sandbox documentation links to point to the correct files 📝 Documentation Updates SDK Example Documentation: Added SDK demo page with TypeScript SDK usage examples and best practices Skills and Commands Documentation: Updated documentation for skills and slash comma"},{"id":"/cli/release-notes/v2.44.0","title":"CodeBuddy Code v2.44.0 Release","body":"CodeBuddy Code v2.44.0 Release ✨ New Features Session Title Synchronization Support for synchronizing session topics through the ACP protocol to the IDE, enabling meaningful session names to be displayed in tabs or sidebars. When the AI assistant identifies a session topic, the IDE can automatically update the corresponding tab title, making it easier for users to identify and manage multiple parallel sessions. 🔧 Improvements SDK Version Update: Updated SDK JS to 0.3.37 and SDK Python to 0.3.35"},{"id":"/cli/release-notes/v2.43.1","title":"CodeBuddy Code v2.43.1 Release","body":"CodeBuddy Code v2.43.1 Release New Features Task Management Tool Refactoring The original single task management tool has been split into 5 independent tools, providing more granular task control capabilities: TaskCreate: Create new tasks TaskGet: Get task details TaskUpdate: Update task status TaskList: List all tasks TaskStop: Stop task execution Skill Tool Enhancement The Skill tool now supports direct execution of slash commands, with a new parameter for passing command arguments, making skill invocation more flexible. Improvements Plan Mode Enhancement: Added command for previewing current plan file content, optimized permission control in plan mode Shell Environment Snapshot: Automatically captures user shell configuration (functions, aliases, options) when executing commands, ensuring commands run in the user's familiar environment Shell Environment File Support: Added environment variable, supporting automatic loading of specified environment files before command execution Prompt Optimization: Optimized Agent prompt templates for improved response conciseness File Search Optimization: Streamlined hardcoded ignore rules, prioritizing project .gitignore configuration Grep Tool: Added parameter alias for improved usability Sub agent Configuration: Added parameter to control agent execution turns"},{"id":"/cli/release-notes/v2.43.0","title":"CodeBuddy Code v2.43.0 Release","body":"CodeBuddy Code v2.43.0 Release New Features Task Management Tool Refactoring The original single task management tool has been split into 5 independent tools, providing more granular task control capabilities: TaskCreate: Create new tasks TaskGet: Get task details TaskUpdate: Update task status TaskList: List all tasks TaskStop: Stop task execution Skill Tool Enhancement The Skill tool now supports direct execution of slash commands, with a new parameter for passing command arguments, making skill invocation more flexible. Improvements Plan Mode Enhancement: Added command for previewing current plan file content, optimized permission control in plan mode Shell Environment Snapshot: Automatically captures user shell configuration (functions, aliases, options) when executing commands, ensuring commands run in the user's familiar environment Shell Environment File Support: Added environment variable, supporting automatic loading of specified environment files before command execution Prompt Optimization: Optimized Agent prompt templates for improved response conciseness File Search Optimization: Streamlined hardcoded ignore rules, prioritizing project .gitignore configuration Grep Tool: Added parameter alias for improved usability Sub agent Configuration: Added parameter to control agent execution turns"},{"id":"/cli/release-notes/v2.42.3","title":"🚀 CodeBuddy Code v2.42.3 Release","body":"🚀 CodeBuddy Code v2.42.3 Release 🔧 Improvements Session Summary and Topic Persistence AI Summary Generation: Automatically generates AI summaries for sessions, displaying friendlier descriptions in the list to help you quickly identify and restore historical sessions Topic Persistence: Terminal titles are now saved to session history for easier viewing and management Non Interactive Mode Support: Added parameter to enable session tracking in non interactive mode Fine Grained Session Tracking Configuration Split session tracking functionality into two independent environment variables for more flexible configuration: : Controls whether to generate session summaries : Controls whether to save session topics This allows you to enable or disable specific features independently based on your actual needs."},{"id":"/cli/release-notes/v2.42.1","title":"🚀 CodeBuddy Code v2.42.1 Release","body":"🚀 CodeBuddy Code v2.42.1 Release 🔧 Improvements Startup Performance Monitoring: Added startup time analyzer, viewable in the panel to see timing for each phase, helping diagnose slow startup issues WSL Environment Support: Automatically detects WSL environment and prompts the model to use correct Linux path format, improving WSL user experience Path Compatibility: Fixed parsing issues when models send Windows style paths on non Windows platforms, avoiding path errors SDK Version Update: Synchronized SDK JS to 0.3.32, SDK Python to 0.3.30"},{"id":"/cli/release-notes/v2.42.0","title":"🚀 CodeBuddy Code v2.42.0 Release","body":"🚀 CodeBuddy Code v2.42.0 Release ✨ New Features MCP Configuration Now Supports JSONC Format MCP configuration files now support JSONC (JSON with Comments) format, making configuration files easier to maintain: Support for single line comments ( ) Support for multi line comments ( ) Support for trailing commas 🔧 Improvements Python 3.10 Support: Agent SDK extended compatible Python version range, now supporting Python 3.10 ACP Session Control: Fixed setting model and permission mode via SDK Tool Call Stability: Automatically detects incomplete tool call parameters returned by the model and requests regeneration, improving conversation stability Session Fork Enhancement: Supports more parameter combinations, allowing source session specification via or Command Message Format: Unified message tag format for slash commands and skills, added tag support for argument extraction Data Tracking Accuracy: Fixed issue where prompt suggestion data was mixed with main conversation data 🐛 Bug Fixes Hook Output Display: Fixed issue where extra JSON raw data was displayed after hook execution Symlink Support: Fixed issue where symlink files in the rules directory couldn't be loaded correctly, added circular reference protection"},{"id":"/cli/release-notes/v2.41.8","title":"🚀 CodeBuddy Code v2.41.8 Release","body":"🚀 CodeBuddy Code v2.41.8 Release 🔧 Improvements Print Mode Output Optimization: Silent notification messages in print mode to avoid polluting agent output stream, making script integration cleaner Configuration Structure Simplification: Removed redundant deploymentType configuration field, simplifying product configuration structure 🐛 Bug Fixes Custom Request Header Parsing: Fixed newline character judgment logic to ensure multi line header configurations are parsed correctly SDK System Prompt Passing: Fixed the issue where parameter was not correctly passed in v2 Session API SDK Session Loading Race Condition: Fixed race condition when calling and concurrently in multi window scenarios, preventing session data inconsistency 📝 Documentation Updates Environment Variable Documentation: Added feature switch documentation for controlling image generation functionality Release Notes: Added Chinese and English release notes for v2.40.0 through v2.41.7 SDK Documentation: Enhanced documentation for hooks, permissions, TypeScript SDK, etc."},{"id":"/cli/release-notes/v2.41.7","title":"CodeBuddy Code v2.41.7 Release","body":"CodeBuddy Code v2.41.7 Release Improvements Checkpoint Performance Optimization: Changed checkpoint file reading to asynchronous parallel processing to avoid blocking the event loop and improve response performance Session Restore Optimization: Improved session/load flow to ensure history messages and artifact restoration execute after response is sent, fixing duplicate sending issues in multi connection scenarios SDK Tool Parameter Passing: Fixed allowedTools/disallowedTools parameter format to ensure correct passing of multiple tool names Python SDK Stream Buffer: Added 100MB buffer limit to prevent errors when MCP services return large JSON responses SDK Version Tracking: SDK automatically injects User Agent header when communicating with CLI, including SDK version and runtime information for backend service tracking and diagnostics SDK Version Updates: Updated SDK JS to 0.3.29 and SDK Python to 0.3.27 Documentation Updates SDK Custom Tools Documentation: Fixed incorrect usage of tool decorator in Python SDK examples, changed to import directly from the package and use correct decorator syntax"},{"id":"/cli/release-notes/v2.41.6","title":"🚀 CodeBuddy Code v2.41.6 Release","body":"🚀 CodeBuddy Code v2.41.6 Release 🔧 Improvements Input Submission Optimization: Fixed an issue where pressing Enter could not submit when typing slash commands. Now commands can be submitted normally, or invalid commands are sent as regular messages Hot Reload Optimization: Fixed an issue where plugins directory hot reload could trigger change events for system directories like , improving stability Context Compression: Optimized history processing logic to filter branch history ensuring compression accuracy Tool Description Template: Optimized quote formatting in tool descriptions for improved readability SDK Version Update: Updated SDK JS to 0.3.28, SDK Python to 0.3.26"},{"id":"/cli/release-notes/v2.41.5","title":"🚀 CodeBuddy Code v2.41.5 Release","body":"🚀 CodeBuddy Code v2.41.5 Release 🐛 Bug Fixes Hot Reload Stability Improvement: Fixed an issue where plugins directory hot reload could trigger change events for system directories like , ensuring more stable and reliable hot reload functionality 🔧 Improvements Session Lock Mechanism Optimization: Delayed session lock acquisition to actual usage time, reducing lock leak risk, while supporting fork operations without acquiring locks, improving session management flexibility SDK Sync Update: Updated SDK JS to 0.3.27, SDK Python to 0.3.25"},{"id":"/cli/release-notes/v2.41.4","title":"🚀 CodeBuddy Code v2.41.4 Release","body":"🚀 CodeBuddy Code v2.41.4 Release 🔧 Improvements SDK Version Sync: Updated SDK JS to 0.3.26, SDK Python to 0.3.24, keeping SDK and CLI versions in sync"},{"id":"/cli/release-notes/v2.41.3","title":"🚀 CodeBuddy Code v2.41.3 Release","body":"🚀 CodeBuddy Code v2.41.3 Release 🔧 Improvements New Kimi K2.5 Model: Added support for Kimi K2.5 model with tool calling, image understanding, and reasoning capabilities, providing users with more model choices Parameter Validation Optimization: Improved tool parameter validation error messages with clearer error information to help quickly locate issues Automatic Type Conversion: Support automatic conversion of string form numeric parameters, improving compatibility with different models Hot Reload Notification Optimization: User level settings.json hot reload no longer displays notifications, reducing unnecessary interruptions"},{"id":"/cli/release-notes/v2.41.2","title":"🚀 CodeBuddy Code v2.41.2 Release","body":"🚀 CodeBuddy Code v2.41.2 Release 🔧 Improvements SDK Version Update: Updated SDK JS to 0.3.24, SDK Python to 0.3.22"},{"id":"/cli/release-notes/v2.41.1","title":"🚀 CodeBuddy Code v2.41.1 Release","body":"🚀 CodeBuddy Code v2.41.1 Release 🔧 Improvements Session Management Optimization: SDK refactored sessionId parameter to be auto generated, simplifying API call flow so developers no longer need to manually manage sessionId SDK Version Update: Updated SDK JS to 0.3.23, SDK Python to 0.3.21"},{"id":"/cli/release-notes/v2.41.0","title":"🚀 CodeBuddy Code v2.41.0 Release","body":"🚀 CodeBuddy Code v2.41.0 Release ✨ New Features Hot Configuration Reload Now when you modify Skills, memory files (CODEBUDDY.md), configuration files, etc., changes take effect automatically without restarting the CLI. Say goodbye to frequent restarts and enjoy a smoother workflow. 🔧 Improvements Tool Whitelist: Added option to limit the set of built in tools CodeBuddy can use. You can set it to an empty string to disable all built in tools, or specify a comma separated list of tools for more controlled tool usage 📝 Documentation Updates Environment Configuration Guide: Added environment variable configuration guidance to SDK, ACP, and IAM documentation, helping users of different versions configure authentication environment correctly"},{"id":"/cli/release-notes/v2.40.1","title":"CodeBuddy Code v2.40.1 Release","body":"CodeBuddy Code v2.40.1 Release Bug Fixes Image Generation Tool: Fixed output directory path parsing error on Windows systems, images are now correctly generated to the specified directory Input Suggestions: Fixed issue where selecting from suggestion menu caused duplicate message sending, improving interaction experience"},{"id":"/cli/release-notes/v2.40.0","title":"CodeBuddy Code v2.40.0 Release","body":"CodeBuddy Code v2.40.0 Release New Features SDK Delayed Control Request Synchronization The SDK now supports delayed control request synchronization, allowing you to flexibly set permission modes and model options before sending messages. This improvement provides SDK users with a more flexible API calling approach, making it convenient to adjust configurations before message submission. Usage Example: Improvements SDK Version Sync: SDK JS updated to 0.3.20, SDK Python updated to 0.3.18, both now support the new delayed control request feature"},{"id":"/cli/release-notes/v2.39.0","title":"CodeBuddy Code v2.39.0 Release","body":"CodeBuddy Code v2.39.0 Release New Features Image Generation Tool Added the tool, enabling the AI assistant to generate images directly from text descriptions. Supports customizable size, style, quality, and other parameters, providing more possibilities for creative workflows. Text to Image Model Switching: Use the command to view and switch available text to image models CLI Parameter Support: Use the parameter at startup to specify the default model Configuration Persistence: Set in user configuration as the default text to image model Improvements Configuration Panel Optimization: Moved the Env Route option to developer mode, activated via or , simplifying the regular configuration interface Input Submission Fix: Fixed the issue where pressing Enter to submit while typing slash commands didn't work; commands can now be submitted normally, or invalid commands sent as regular messages Tool Description Optimization: Improved quote formatting in tool descriptions for better readability SDK Version Update: Updated SDK JS to 0.3.19 and SDK Python to 0.3.17"},{"id":"/cli/release-notes/v2.38.2","title":"CodeBuddy Code v2.38.2 Release","body":"CodeBuddy Code v2.38.2 Release Improvements Path Resolution Optimization: Unified path resolution logic for WASM files and certificate files using PathUtils, supporting loading embedded resources from EMBEDFS, improving compatibility across different deployment environments Bug Fixes Console Output: Fixed an issue where console output mode parsing failed in certain scenarios"},{"id":"/cli/release-notes/v2.38.1","title":"CodeBuddy Code v2.38.1 Release","body":"CodeBuddy Code v2.38.1 Release Improvements Command Safety Check Simplification: Removed unused command blacklist functionality, streamlined code structure, and improved code maintainability SDK Version Sync: Updated SDK JS to 0.3.17 and SDK Python to 0.3.15"},{"id":"/cli/release-notes/v2.38.0","title":"CodeBuddy Code v2.38.0 Release","body":"CodeBuddy Code v2.38.0 Release New Features Sub Agent Model Variants The Task tool now supports a parameter for specifying model variants like and . You can choose the appropriate model based on task complexity: : Suitable for lightweight tasks such as simple searches and quick file operations : Suitable for complex analysis, architectural decisions, and multi step problem solving Improvements Checkpoint Hook Statistics Optimization: Optimized file change statistics calculation by comparing backup files with current files to provide accurate line addition and deletion counts Shell Encoding Handling: Optimized character encoding/decoding logic for terminal output, improving display of Chinese and other non ASCII characters on Windows SDK Version Update: Updated SDK JS to 0.3.16 and SDK Python to 0.3.14 Documentation Updates Environment Requirements: Clarified that the minimum Node.js version is 18.20+ Development Documentation: Enhanced CODEBUDDY.md with development commands, directory structure descriptions, and build process details Documentation Sync: Synchronized CLI documentation to the IDE docs directory, added cost documentation, etc."},{"id":"/cli/release-notes/v2.37.20","title":"CodeBuddy Code v2.37.20 Release","body":"CodeBuddy Code v2.37.20 Release Improvements Model Temporary Switch: Press key in model selection panel to apply only to current session without modifying user configuration, convenient for temporarily testing different models model Parameter Optimization: Command line parameter now correctly overrides project level configuration, taking effect immediately in current session Context Compression Optimization: Filter rules and memory content during compression to avoid compressing configuration instructions into summary, automatically re inject complete rules after compression to maintain AI behavior consistency Configuration Panel Simplification: Hide developer options, accessible via , making configuration interface cleaner"},{"id":"/cli/release-notes/v2.37.19","title":"CodeBuddy Code v2.37.19 Release","body":"CodeBuddy Code v2.37.19 Release Improvements SDK Version Sync: Updated JavaScript/TypeScript SDK to 0.3.14, Python SDK to 0.3.12, keeping SDK in sync with CLI version for optimal compatibility"},{"id":"/cli/release-notes/v2.37.18","title":"CodeBuddy Code v2.37.18 Release","body":"CodeBuddy Code v2.37.18 Release Bug Fixes Login Flow Optimization: Fixed login method mapping configuration issue, improving login interface interaction experience and usability Improvements SDK Version Update: Sync updated SDK JS to 0.3.13, SDK Python to 0.3.11, maintaining compatibility with latest SDK"},{"id":"/cli/release-notes/v2.37.17","title":"CodeBuddy Code v2.37.17 Release","body":"CodeBuddy Code v2.37.17 Release Improvements SDK Version Sync Update: SDK JS updated to 0.3.12, SDK Python updated to 0.3.10, ensuring sync with CLI version"},{"id":"/cli/release-notes/v2.37.16","title":"CodeBuddy Code v2.37.16 Release","body":"CodeBuddy Code v2.37.16 Release Improvements Configuration Update: Included robot configuration file in build process to ensure configuration sync update Bug Fixes Enterprise Edition Login Compatibility: Fixed issue where model list was inconsistent when users switched to enterprise edition URL login, ensuring configuration loads correctly after endpoint change"},{"id":"/cli/release-notes/v2.37.15","title":"CodeBuddy Code v2.37.15 Release","body":"CodeBuddy Code v2.37.15 Release Bug Fixes Logout Flow Optimization Fixed issue where token was not properly cleared after logout, ensuring authentication interceptor correctly handles logout state, avoiding subsequent requests using expired credentials. HTTP Interceptor Enhancement Improved error handling and state synchronization mechanism of authentication HTTP interceptor, improving stability and reliability of authentication flow."},{"id":"/cli/release-notes/v2.37.14","title":"CodeBuddy Code v2.37.14 Release","body":"CodeBuddy Code v2.37.14 Release New Features SDK Dynamic Configuration API Added and methods, allowing developers to dynamically retrieve currently available permission modes and model lists. Additionally, and now only affect the current session and no longer persist to configuration files, making configuration management more flexible in multi session scenarios. Model Switch Shortcut Support Option/Alt + P to quickly switch models without entering settings. Improvements User Hints Enhancement: Added more built in hints to help users learn shortcuts and operation tips Output Limit Unification: Unified token limit for all tools to 20000, image content is not subject to this limit; Read tool supports environment variable for customization Startup Performance Optimization: Optimized authentication and service configuration initialization flow, improving CLI cold start speed Plugin Marketplace Installation: Optimized marketplace and plugin installation flow, significantly reducing wait time for first installation and auto updates Async File Operations: Changed custom commands, Agent, and Skill loading to async parallel processing Git Info Collection: Optimized repository scanning logic with async parallel processing for improved performance Bug Fixes Diff Rendering Stability: Fixed rendering crash caused by empty strings or incomplete JSON during tool call parameter parsing"},{"id":"/cli/release-notes/v2.37.13","title":"CodeBuddy Code v2.37.13 Release","body":"CodeBuddy Code v2.37.13 Release Improvements Enterprise Edition Authentication Optimization Optimized enterprise ID acquisition timing to ensure enterprise model list loads correctly after user login, improving enterprise user experience. Custom Authentication Fix Fixed issue where token was lost during authentication state changes in custom authentication environments, ensuring stability and reliability of authentication flow."},{"id":"/cli/release-notes/v2.37.12","title":"CodeBuddy Code v2.37.12 Release","body":"CodeBuddy Code v2.37.12 Release UI Optimization App Icon Update: Updated Work app icon for improved visual consistency Improvements Activity Bar Enhancement: Added activity bar component, supporting richer navigation and interaction features Settings Service Optimization: Refactored settings service for more flexible configuration management History Cache: Added history cache service, improving session history loading and management experience Process Pool Management: Introduced ACP process pool, improving resource utilization efficiency in multi session scenarios Mermaid Diagrams: Enhanced Mermaid diagram rendering, supporting more chart types and interactions Internationalization Completion: Added Chinese and English interface text"},{"id":"/cli/release-notes/v2.37.11","title":"CodeBuddy Code v2.37.11 Release","body":"CodeBuddy Code v2.37.11 Release Maintenance Update This is a maintenance release, mainly including: SDK version sync update Internal dependency optimization"},{"id":"/cli/release-notes/v2.37.10","title":"CodeBuddy Code v2.37.10 Release","body":"CodeBuddy Code v2.37.10 Release Improvements Login Method Optimization: Simplified login options to \"Chinese Site\", \"International Site\" and \"Enterprise Domain\", domestic site login will automatically select the best authentication method based on network environment, improving login experience"},{"id":"/cli/release-notes/v2.37.9","title":"CodeBuddy Code v2.37.9 Release","body":"CodeBuddy Code v2.37.9 Release Improvements Sidebar Interaction Optimization: Support drag to adjust width, added session management action buttons, making interface operations more flexible and convenient User Agent Identification: ACP process automatically sets User Agent request header containing version info on startup, facilitating server side client version identification Configuration Sync Optimization: Added throttle + debounce mechanism for product configuration sync, reducing performance overhead from high frequency calls Log Enhancement: Added debug logs for streaming message processing and configuration cache expiration, facilitating issue troubleshooting"},{"id":"/cli/release-notes/v2.37.8","title":"CodeBuddy Code v2.37.8 Release","body":"CodeBuddy Code v2.37.8 Release Improvements Session State Management Optimization: Optimized lastMessageId update mechanism during async compaction, ensuring correct message ID association in long conversation scenarios, improving session recovery reliability"},{"id":"/cli/release-notes/v2.37.7","title":"CodeBuddy Code v2.37.7 Release","body":"CodeBuddy Code v2.37.7 Release New Features Red Packet Cover Promotion: Help panel adds \"Code to Success\" red packet cover claim entry, automatically displays corresponding link based on domestic/international version, helping you claim exclusive red packet covers during the New Year"},{"id":"/cli/release-notes/v2.37.6","title":"CodeBuddy Code v2.37.6 Release","body":"CodeBuddy Code v2.37.6 Release Improvements Session Recovery Enhancement: Support displaying sessions generated by command, users no longer lose session history after compaction"},{"id":"/cli/release-notes/v2.37.5","title":"CodeBuddy Code v2.37.5 Release","body":"CodeBuddy Code v2.37.5 Release Bug Fixes ACP Session Model Setting: Fixed issue where subsequent conversations still used the old model after switching models via SDK, model switching now takes effect immediately"},{"id":"/cli/release-notes/v2.37.4","title":"CodeBuddy Code v2.37.4 Release","body":"CodeBuddy Code v2.37.4 Release New Features Custom Session ID SDK now supports specifying custom session IDs when creating sessions, making it easier for external systems to track and manage sessions. This is useful for scenarios that require integrating CodeBuddy sessions with business systems. Bug Fixes Session History Loading: Fixed issue where historical messages couldn't display correctly after session reconnection, now using ACP session/load mechanism to load history Model Selection Sync: Fixed model ID mapping issue, properly handling the modelId field returned by SDK Model Persistence: Optimized model selection persistence logic to ensure user selections remain consistent after session reconnection Session Subscription Stack Overflow: Prevented recursive stack overflow caused by repeated session subscriptions Stop Hook Serialization: Removed unused result field to avoid errors caused by serialization circular references Improvements Tool Steps Display: Optimized tool call list layout and animation effects for better visual experience"},{"id":"/cli/release-notes/v2.37.3","title":"🚀 CodeBuddy Code v2.37.3 Release","body":"🚀 CodeBuddy Code v2.37.3 Release 🔧 Improvements Electron Desktop Application Experience Optimization Single Instance Lock: Prevents multiple application instances; the second instance will automatically focus the existing window macOS Window Behavior: Closing the window now hides rather than quits the application, conforming to macOS application standards Dock Icon Cleanup: Fixed issue where child processes displayed extra icons in the macOS Dock SDK API Enhancement Dynamic Permission Mode Switching: Session API added and methods, supporting dynamic permission mode switching within sessions Plan Mode Optimization: Switching to plan mode now returns the plan file path, making it easier for SDK to retrieve and display History Message Handling: Optimized history message processing flow in resume + prompt scenarios for Query API Message List Interaction Optimization Timeline Sorting: Optimized timeline sorting for messages and tool calls, supporting grouped display of tool calls Feedback Feature: Added message like and dislike buttons, supporting user feedback Image Preview: User message images now support click to enlarge preview with smooth animation effects Copy Feature: Improved assistant message copy logic, supporting copying complete reply groups; user messages support double click to copy"},{"id":"/cli/release-notes/v2.37.2","title":"🚀 CodeBuddy Code v2.37.2 Release","body":"🚀 CodeBuddy Code v2.37.2 Release 🔧 Improvements ACP Authentication Enhancement User information is now returned in the authenticate response, allowing clients to get the current logged in user's ID, username, and nickname Fixed issue where calling the authentication API again for already logged in users would not display the login page Asynchronous Context Compression Introduced asynchronous context compression mechanism that automatically triggers background compression when conversation history reaches a critical threshold, improving response performance in long conversation scenarios. SDK Connection Performance Optimization Optimized connection pool mechanism with prewarmed connection reuse for concurrent query scenarios, significantly reducing first message latency Added option to move CLI startup time to the prewarm phase Added session lock mechanism to prevent data confusion caused by concurrent restoration of the same session ID Other Improvements ACP Session Model Isolation: Fixed issue where switching models affected global configuration; model switching now only affects the current session Plugin Uninstall Cleanup: Fixed issue where MCP configuration remained after uninstalling plugins; related configuration is now automatically cleaned up during uninstallation Network Error Handling: Optimized automatic retry logic for network errors in print mode to avoid abnormal exits SDK Performance Optimization: Optimized session restoration and user interaction flow, improving SDK response speed and stability Session Storage: Support cross project directory session search, added meta file separated storage Authentication Flow: Optimized authentication mechanism, added user information query interface Service Mode: Enhanced server mode policy functionality"},{"id":"/cli/release-notes/v2.37.1","title":"🚀 CodeBuddy Code v2.37.1 Release","body":"🚀 CodeBuddy Code v2.37.1 Release 🔧 Improvements Authentication API Enhancement Added API to support clearing cached authentication tokens, allowing you to easily switch users or environments. Additionally, now automatically detects existing valid authentication, avoiding redundant logins and improving user experience. Checkpoint Hook Added experimental Hook that triggers automatically after file modifications. This Hook provides file snapshots and change statistics, facilitating file change history tracking and automated auditing, offering more powerful support for code quality management. Session API Hooks Support V2 Session API now supports configuring Hooks, enabling interception and control of tool execution within sessions. This allows you to customize session behavior more flexibly and achieve finer grained execution control."},{"id":"/cli/release-notes/v2.37.0","title":"🚀 CodeBuddy Code v2.37.0 Release","body":"🚀 CodeBuddy Code v2.37.0 Release ✨ New Features SDK Authentication API Added experimental authentication interface to support SDK independent login flow: Supports multiple authentication environments (external, internal, iOA, cloudhosted, selfhosted) Automatically detects login status to avoid duplicate login Notifies login URL via callback, supports custom browser opening logic 🔧 Improvements and Optimizations React State Management: Refactored message status update logic to use immutable operations instead of direct modification, following React best practices and improving component rendering stability"},{"id":"/cli/release-notes/v2.36.3","title":"🚀 CodeBuddy Code v2.36.3 Release","body":"🚀 CodeBuddy Code v2.36.3 Release 🔧 Improvements & Optimizations Enhanced Cross Platform Compatibility: Improved path handling for Shell execution on Windows systems, fixing execution issues caused by paths containing spaces Enhanced Permission Matching: Improved permission rule matching for complex Shell commands, supporting command parsing with operators such as , , , , enabling permission rules to accurately match individual sub commands within combined commands Input Menu Response Optimization: Fixed keyboard shortcut conflicts caused by menu status detection delays, improving response speed for command and file suggestion menus History Record Filtering: Optimized message display when loading session history 🐛 Bug Fixes Circular Dependency Fix: Resolved circular reference issues between modules, improving service isolation through deferred dependency retrieval 📝 Documentation Updates SDK Documentation Correction: Corrected custom tool import paths; and should be imported directly from SDK Version Requirement Update: Updated CodeBuddy Agent SDK version requirement in documentation from v0.2.0 to v0.1.24"},{"id":"/cli/release-notes/v2.36.2","title":"🚀 CodeBuddy Code v2.36.2 Release","body":"🚀 CodeBuddy Code v2.36.2 Release 🔧 Improvements Team Task Management Added team task management slash commands, supporting task entry, viewing, starting, and completion workflows, helping teams collaborate more efficiently and track task progress. Also optimized the task ID format, adopting a date + random hex format to avoid ID conflicts during parallel multi branch development. Flowchart Generation Added the slash command, supporting the generation of sketch style drawio flowcharts, making it easy to quickly create and visualize workflows. Tool Return Result Rendering: Improved standardized handling of tool call results and error interruption display, optimized text display and line break logic in the StreamToolCall component Authentication Source Display: Displays the current authentication method being used (environment variables, apiKeyHelper script, or logged in account) in the status panel, making it easy to understand the current authentication status Documentation Link Website Update: Documentation links in CLI help information updated to official website addresses, with www.codebuddy.ai for the international version and copilot.tencent.com for the domestic version Model Compatibility Optimization: Improved compatibility for models that do not support images when using file reading tools, avoiding errors caused by image content Bashes Panel: Optimized layout and style display, improving interaction experience 🐛 Bug Fixes Input History: Fixed the issue where pressing the down arrow after browsing history with the up arrow could not restore the input draft Input History: Fixed the issue where only the last entry was retained in history after entering multiple consecutive items"},{"id":"/cli/release-notes/v2.36.1","title":"🚀 CodeBuddy Code v2.36.1 Release","body":"🚀 CodeBuddy Code v2.36.1 Release 🔧 Improvements Windows Platform Performance Optimization: Optimized machine ID retrieval and Bash path lookup logic on the Windows platform, significantly improving startup speed and response performance, delivering a smoother experience for Windows users"},{"id":"/cli/release-notes/v2.36.0","title":"🚀 CodeBuddy Code v2.36.0 Release","body":"🚀 CodeBuddy Code v2.36.0 Release 🔧 Improvements Enhanced SDK Error Handling Enhanced error handling capabilities in JavaScript and Python SDKs to provide developers with clearer error messages and more reliable exception catching mechanisms. Session Recovery Feature Improvements Optimized handling of edge cases in session recovery functionality, improving recovery stability and accuracy in various exceptional scenarios. Example Code Additions Added example code for authentication error handling and session management to help developers better understand and use SDK features. Type Definition Optimization Optimized SDK type definitions to provide better type safety support, reduce type errors, and improve development experience. SDK MCP Feature Optimization Optimized the Python SDK's MCP functionality and query interface implementation, improving the stability and usability of MCP integration."},{"id":"/cli/release-notes/v2.35.0","title":"🚀 CodeBuddy Code v2.35.0 Release","body":"🚀 CodeBuddy Code v2.35.0 Release ✨ New Features Structured Output Support specifying JSON Schema through the command line parameter to make Agent output conform to predefined data structures. This feature is particularly useful for scenarios that require programmatic processing of Agent output, such as automated workflows and data pipeline integration. 🔧 Improvements Enhanced Concurrency Safety: Added cross process file locking mechanism to provide reliable concurrency protection for settings and update operations, avoiding data conflicts when multiple instances are running Hook System Refactoring: Unified the scheduling and execution of internal hooks and external shell hooks, improving extensibility and consistency MCP Server Management: Refactored disabled state management to support configuration persistence across different scopes, making configuration more flexible Context Compression Optimization: Fixed logic issues with message queue processing and tool approval interruption after compression Terminal Experience Enhancement: Optimized terminal title update timing for faster response Model Configuration Update: Added support for GPT 5.2 Codex model and adjusted model naming conventions 🐛 Bug Fixes Markdown Table Rendering: Fixed issues where links, code snippets, and other content within table cells could not be formatted correctly Configuration Concurrency Issues: Improved concurrent safety of configuration file read/write operations SDK Dependency Fix: Fixed compilation errors caused by missing MCP SDK dependencies in agent sdk js"},{"id":"/cli/release-notes/v2.34.1","title":"CodeBuddy Code v2.34.1 Release","body":"CodeBuddy Code v2.34.1 Release 🔧 Improvements Memory Loading Logs: Enhanced log output when loading Memory rules, displaying detailed loading information for easier debugging Shell Detection: Optimized shell type detection logic, supporting override of default shell through the environment variable PTY Compatibility: Improved PTY loading logic on Linux systems, automatically detecting GLIBC version and musl systems to avoid loading failures on incompatible environments"},{"id":"/cli/release-notes/v2.34.0","title":"🚀 CodeBuddy Code v2.34.0 Release","body":"🚀 CodeBuddy Code v2.34.0 Release ✨ New Features SDK MCP Server Support Added SDK MCP Server type, allowing registration and management of MCP servers through the SDK's internal messaging mechanism, providing SDK developers with more flexible tool extension capabilities. 🔧 Improvements MCP Connection Stability: When MCP servers fail to respond normally, the current session is no longer interrupted. Instead, error information is logged and operation continues, improving the user experience Context Compression Fix: Fixed errors caused by session state processing exceptions during context compression Configuration Save Optimization: Use deep comparison to determine default values, avoiding misidentification of object/array type configuration items Plan Mode Interaction Experience: Optimized the Plan Mode tool confirmation interface display, enhancing user interaction experience when using plan mode Command Display Optimization: Improved command display in the Bash tool permission confirmation interface, supporting multi line text wrapping display Session Recovery Enhancement: SDK automatically returns historical messages when recovering sessions, supporting viewing of previous conversation history Subdirectory Rules Loading: Support lazy loading of CODEBUDDY.md rule files in subdirectories, using LRU cache to improve performance 🐛 Bug Fixes Suggestion Fix: Fixed errors caused by missing tool call results in exceptional situations 📝 Documentation Updates SDK MCP Integration Guide: Detailed introduction on how to integrate and use MCP servers in CodeBuddy Agent SDK SDK Custom Tools Guide: Demonstrates how to create and use custom tools directly integrated in the SDK Authentication Documentation: Added environment variable configuration instructions for China version, Overseas version, and iOA version"},{"id":"/cli/release-notes/v2.33.1","title":"CodeBuddy Code v2.33.1 Release","body":"CodeBuddy Code v2.33.1 Release Improvements & Optimizations Session Context Type Optimization: Refactored type definitions for sessions, checkpoints, and context management, enhancing type safety for input item handling and history tools Command Permission Check: Optimized permission evaluation for whitelisted command chains, directly allowing execution when all subcommands are in the safe whitelist without additional confirmation Memory Loader: Fixed compilation warnings caused by temporarily disabled subdirectory Memory loading methods"},{"id":"/cli/release-notes/v2.33.0","title":"CodeBuddy Code v2.33.0 Release","body":"CodeBuddy Code v2.33.0 Release New Features Model Selection Memory When opening the model panel, it now automatically scrolls to the currently active model, eliminating the need to manually search for it. Improvements & Optimizations LSP Position Conversion: Fixed coordinate conversion logic between editor line/column numbers and LSP server, enabling accurate positioning for code navigation and reference lookup operations Message Queue Stability: Fixed an issue where messages sent by users during Agent execution could be lost, ensuring messages are correctly preserved in multi turn conversations Input Suggestions Optimization: Added debounce mechanism to reduce unnecessary requests and improve input experience Performance Optimization: Reduced unnecessary component re renders to improve interface responsiveness Stability Improvement: Fixed potential crash issues in empty list scenarios Subdirectory Rules Support: Support for placing CODEBUDDY.md files in project subdirectories, with rules automatically triggered when operating on files in that directory File Extension Compatibility: Added support for extension (CODEBUDDY.mdc, AGENTS.mdc) Glob Matching Optimization: Enabled matchBase mode, allowing simple patterns like to match files at any directory level Conditional Rule Injection Enhancement: Automatic conditional rule matching triggered during file operation tool execution Bug Fixes Context Compression: Fixed an issue where interrupting a session during compression incorrectly displayed an interruption message Documentation Updates Tool Documentation: Added documentation for NotebookEdit, LSP, and TaskOutput tools CLI Parameters: Added documentation for and parameters"},{"id":"/cli/release-notes/v2.32.0","title":"🚀 CodeBuddy Code v2.32.0 Release","body":"🚀 CodeBuddy Code v2.32.0 Release ✨ New Features Prompt Suggestions After the Agent completes a conversation, CodeBuddy automatically predicts your next possible action and displays it as gray text in the input area. Press Enter to send the suggestion directly, or press Tab to enter edit mode, making your workflow smoother. 🔧 Improvements & Optimizations Context Management: Fixed exception handling logic during MCP tool information collection, improving system stability Configuration System: Optimized default value merging logic, fixed loading issues across different configuration layers Background Task Management: Optimized task registration mechanism, supporting selective state monitoring, reducing resource overhead File Search Tool: Enhanced file path matching algorithm and Git ignore rule processing, improving search accuracy Error Handling: Improved network error logging, enhancing problem troubleshooting capabilities 📝 Documentation Updates MCP Configuration Documentation: Updated MCP configuration file location description, added priority based configuration file parsing mechanism"},{"id":"/cli/release-notes/v2.31.2","title":"🚀 CodeBuddy Code v2.31.2 Release","body":"🚀 CodeBuddy Code v2.31.2 Release 🔧 Improvements & Optimizations Session History Enhancement: Each history message now automatically records the working directory at the time of creation, facilitating message source tracking Idle Prompt Notification: Automatically sends terminal notification to remind users when there's no operation 60 seconds after user input, preventing forgotten ongoing tasks MCP Configuration Path Consistency: Fixed path priority logic in toggle manager when reading/writing configurations, ensuring consistency with config store behavior OSC Notification Protocol Optimization: Adjusted terminal protocol priority, providing dedicated OSC 9 support for iTerm, improving compatibility experience Notification Message Simplification: Removed product name prefix from notification messages, making messages more concise and clear Plan Mode Optimization: Improved plan approval flow and storage mechanism, enhancing user experience MCP Configuration System: Optimized MCP configuration scope architecture, improving configuration isolation and security Documentation Optimization: Removed redundant directory structure from documentation, simplifying document content 🐛 Bug Fixes Directory Trust Matching: Fixed issue where recursive trust patterns couldn't match the directory itself, ensuring directory trust functionality works correctly"},{"id":"/cli/release-notes/v2.31.1","title":"CodeBuddy Code v2.31.1 Release","body":"CodeBuddy Code v2.31.1 Release 🔧 Improvements & Optimizations File Search Tool: Optimized glob pattern processing logic, improving pattern standardization accuracy Shell Compatibility Hints: Added default Shell type in environment info and command execution prompts, ensuring generated commands are compatible with user Shell syntax Plugin Marketplace Git Operations: Disabled Git credential prompts and interactive SSH authentication, improving plugin installation experience in unattended environments 🐛 Bug Fixes File Permission Check: Fixed issue requiring repeated authorization when reading files within workspace; now trusted workspace directories automatically recursively trust all their subfiles"},{"id":"/cli/release-notes/v2.31.0","title":"🚀 CodeBuddy Code v2.31.0 Release","body":"🚀 CodeBuddy Code v2.31.0 Release ✨ New Features ACP HTTP Transport Protocol Added Streamable HTTP transport mode, providing more flexible integration options for ACP protocol: Support using ACP protocol through HTTP endpoints Enable via parameter Includes companion client SDK for quick integration Feedback Command Added command for quickly submitting feedback or bug reports, automatically opens browser with pre filled session information. Session History API The endpoint now supports retrieving conversation message lists from historical sessions, facilitating IDE integration development. Plugin Management Interface Enhancements Brand new plugin management experience with 6 new functional tabs: Discover/Browse: Discover and browse available plugins Installed: Manage installed plugins Marketplaces: Manage plugin marketplace sources Errors: View detailed error diagnostics, supporting 20+ error type categories Added command to verify plugin validity 🔧 Improvements New Model Support: Added support for Kimi K2 Thinking reasoning model UI Rendering Performance: Optimized terminal interface rendering, improved message display fluency Service Proxy: Hook scripts can call gateway services through service proxy LSP Integration: Improved Windows platform compatibility, fixed path space issues, enhanced C and other language server compatibility Permission Management: Optimized auto approval logic for safe commands in Plan mode Checkpoint Comparison: Support comparing disk files with snapshot difference statistics Conversation Recovery: Display checkpoint time information in recovery selector Workspace Rules: Optimized rule injection tags, improved AI rule recognition capability 🐛 Bug Fixes Rule Import: Fixed issue where imported rules were incorrectly skipped when Context Compression: Fixed issue where tool approval requests still popped up after compression 📝 Documentation Updates ACP Documentation: Added transport protocol selection and HTTP transport usage instructions En"},{"id":"/cli/release-notes/v2.30.1","title":"🚀 CodeBuddy Code v2.30.1 Release","body":"🚀 CodeBuddy Code v2.30.1 Release 🔧 Improvements File Search Tool: Optimized search logic, improved code readability and execution efficiency"},{"id":"/cli/release-notes/v2.30.0","title":"🚀 CodeBuddy Code v2.30.0 Release","body":"🚀 CodeBuddy Code v2.30.0 Release ✨ New Features Built in Plugin Marketplace Added CodeBuddy official plugin marketplace, providing officially recommended quality plugins for users to quickly discover and install. 🔧 Improvements Conversation Compression Display: Improved the interface display of conversation compression feature, providing clearer visual feedback File Search Pagination: Added and parameter support for Glob tool, enabling pagination processing for large search results Content Search Pagination: Added parameter and optimized handling for Grep tool, enhancing search result flexibility API Key Configuration: Support configuring API Key through settings, providing more flexible authentication options MCP Configuration Path Display: Improved MCP server configuration file path display logic, correctly showing path information for all configuration scopes MCP Service Management: Disabled MCP services can now view their detail pages Tool Permission Control: Optimized tool permission approval process, enhancing security control capabilities for specific tool operations Directory Trust Optimization: Users can now choose to trust the current directory, parent directory, or recursively trust all subdirectories in the directory trust prompt, avoiding repeated authorization for subdirectories Checkpoint Protocol Optimization: Extracted common data structures, reduced code duplication, optimized session data structures and restore conversation UI"},{"id":"/cli/release-notes/v2.29.0","title":"🚀 CodeBuddy Code v2.29.0 Release","body":"🚀 CodeBuddy Code v2.29.0 Release ✨ New Features Session Resume Support Added session resume functionality, supporting seamless resumption and switching of existing sessions in IDE integration scenarios, improving continuity and efficiency of cross session workflows. LSP Plugin Support Added Language Server Protocol plugin support, providing real time code intelligence for AI: Understand code structure, type definitions, and function signatures Support cross file symbol navigation and reference lookup Improve accuracy and efficiency of code analysis 🔧 Improvements Authentication Performance: Optimized authentication flow, reduced unnecessary configuration checks, improved startup speed UI Component Optimization: Improved loading state display component, enhanced rendering efficiency and code structure Sub agent Tracking: Enhanced internal tracking mechanism for sub agent task execution, improved event stream processing accuracy 🐛 Bug Fixes Session Management: Fixed CLI Agent session ID management issue, improved session persistence and recovery stability Startup Command: Fixed issue where command could not execute properly Network Exception Handling: Fixed error propagation issue caused by network exceptions during sub agent execution, improved task execution stability Todo List: Optimized command data loading logic, supports recovering todo list from file system MCP Connection: Improved MCP server connection mechanism, supports custom timeout configuration, improved connection reliability 📝 Documentation Updates Authentication: Restructured IAM documentation, added quick start guide and scenario based authentication configuration examples Plugin Development: Updated plugin development documentation, added LSP configuration guide and usage examples Release Notes: Added v2.28.1 release notes documentation Documentation Index: Updated CLI documentation index mapping"},{"id":"/cli/release-notes/v2.28.1","title":"🚀 CodeBuddy Code v2.28.1 Release","body":"🚀 CodeBuddy Code v2.28.1 Release 🐛 Bug Fixes Double ESC rollback feature: Fixed an issue where pressing ESC twice consecutively when the input field was empty failed to trigger the conversation rollback feature correctly. Now you can use the keyboard shortcut to quickly access the conversation rollback panel"},{"id":"/cli/release-notes/v2.28.0","title":"🚀 CodeBuddy Code v2.28.0 Release","body":"🚀 CodeBuddy Code v2.28.0 Release ✨ New Features Code Security Review Command: Added command for professional code security audits to identify potential vulnerabilities Conditional Rule Loading: Support for automatically loading relevant rules based on file operations, configured via the field matching patterns Modular Rule Management: Support for organizing rule files in the directory with subdirectory categorization Local Memory Configuration: Added file support for personal preference settings, excluded from version control AI Model Expansion: Added support for GLM 4.6V and DeepSeek V3.2 models Homebrew Installation: macOS/Linux users can now install directly via 🔧 Improvements & Optimizations Custom Command Rendering: Improved command template parsing with support for inline Bash command execution Memory Loading Mechanism: Optimized rule triggering for improved loading efficiency MCP Tool List: Enhanced stability when fetching server tools Error Message Optimization: Improved error message readability for easier troubleshooting Enhanced Logging: Added detailed logs for settings management to facilitate debugging Homebrew Update Detection: Now correctly detects updates for Homebrew installations MCP Output Limits: Improved tool output size calculation method MCP Timeout Configuration: Support for configuring connection timeout via environment variables 🐛 Bug Fixes Agent Tool Configuration: Fixed file reading capability configuration issue for compact agent Windows IDE Connection: Improved Windows platform IDE process detection for better connection stability"},{"id":"/cli/release-notes/v2.27.3","title":"🚀 CodeBuddy Code v2.27.3 Release","body":"🚀 CodeBuddy Code v2.27.3 Release 🔧 Improvements & Optimizations MCP server status display: Improved status presentation for pending approval servers, providing clearer visibility into connection states Auto update stability: Optimized update lock mechanism to prevent update loops in edge cases File search consistency: Unified file ignore rules management, improving search result accuracy UI responsiveness: Simplified output panel layout for faster interface response 🐛 Bug Fixes Complex task handling: Fixed issues where subtasks couldn't complete due to execution limits, now capable of handling more complex multi step tasks Context compression quality: Improved file reading capability during context compression, enhancing content accuracy after compression Subtask stability: Fixed unexpected message forwarding issues in subtasks, improving task execution isolation SDK mode optimization: Improved handling logic for permission denials, enhancing SDK integration experience"},{"id":"/cli/release-notes/v2.27.2","title":"🚀 CodeBuddy Code v2.27.2 Release","body":"🚀 CodeBuddy Code v2.27.2 Release 🐛 Bug Fixes Alpine Linux compatibility fix: Resolved crash issues when running on Alpine and other musl based systems, improving cross platform stability MCP connection optimization: Fixed transport layer conflicts caused by concurrent connection requests, improving connection stability Command execution optimization: Improved MCP initialization logic for one time commands, reducing unnecessary connection overhead"},{"id":"/cli/release-notes/v2.27.1","title":"🚀 CodeBuddy Code v2.27.1 Release","body":"🚀 CodeBuddy Code v2.27.1 Release 🔧 Improvements & Optimizations Enhanced error messages: Improved accuracy and readability of error messages to help you identify and resolve issues faster Network connection enhancement: Automatic detection of network fluctuations with retry mechanism, improving service stability and availability UI display improvements: Unified presentation of tool call results and async task completion notifications for a more consistent interaction experience 🐛 Bug Fixes File path suggestions optimization: Fixed inaccurate path suggestions during file search, improving input efficiency Input experience improvement: Eliminated suggestion list flickering during interactive input for a smoother input experience Startup speed boost: Resolved blocking issues during plugin marketplace initialization, accelerating startup response time Token statistics accuracy: Fixed token calculation logic to ensure accurate usage statistics Error diagnostics enhancement: Improved error message extraction and display mechanism, providing more detailed and useful diagnostic information Network retry optimization: Refined handling strategy for timeouts and connection interruptions, reducing operation failures caused by network fluctuations"},{"id":"/cli/release-notes/v2.27.0","title":"🚀 CodeBuddy Code v2.27.0 Release","body":"🚀 CodeBuddy Code v2.27.0 Release ✨ New Features Conversation Rewind: New command that allows rewinding the conversation to a previous message point, with options to rewind conversation only, code only, or both File Checkpoints: Support for automatically creating file checkpoints during sessions, allowing file restoration to previous states when rewinding Plugin Marketplace Auto Update: Support for enabling auto update for the plugin marketplace, automatically syncing marketplace content on startup, executed asynchronously in the background without affecting startup speed 🔧 Improvements & Optimizations Shortcut Enhancement: New double press ESC shortcut to activate rewind feature. When the input box is empty, pressing ESC twice quickly enters the conversation rewind panel 🐛 Bug Fixes Plugin Config Parsing Fix: Fixed plugin marketplace configuration parsing issues, supporting multiple configuration formats to improve configuration compatibility Build Script Permission Fix: Fixed issue where binary file executable permissions were lost during wheel package build process"},{"id":"/cli/release-notes/v2.26.0","title":"🚀 CodeBuddy Code v2.26.0 Release","body":"🚀 CodeBuddy Code v2.26.0 Release ✨ New Features Skills Panel: Added command to quickly view all loaded Skills (including user level, project level, and plugin level), displaying estimated token consumption to help you better manage and optimize context usage 🔧 Improvements and Optimizations Context Information Display Optimization: Enhanced command to improve the display of skills and custom commands, grouping by scope and sorting by token usage, giving you clear insight into context consumption details Task List Persistence: Task lists in sessions are now automatically saved, ensuring complete task state is maintained even after context compression, making long duration session management more reliable Terminal and Editor Support Expansion: Added automatic recognition support for Kitty and Alacritty terminals and Zed editor; expanded JetBrains IDE series recognition capabilities (including IntelliJ IDEA, WebStorm, PhpStorm, GoLand, Rider, CLion, RubyMine, DataGrip, etc.) Tool Invocation Stability Enhancement: Improved tool name matching capabilities to increase success rate and accuracy of Agent tool invocations Code Diff Experience Enhancement: Improved text highlighting in the diff view for easier and more efficient code reviews Code Size Optimization: Removed unused internal tools to reduce program size 🐛 Bug Fixes Sub Agent Event Handling: Fixed the issue where sub agent task result events were duplicately propagated to the main session, improving stability of multi agent collaboration"},{"id":"/cli/release-notes/v2.25.1","title":"🚀 CodeBuddy Code v2.25.1 Release","body":"🚀 CodeBuddy Code v2.25.1 Release ✨ New Features SDK System Prompt Configuration: SDK supports customizing system prompts through configuration options, flexibly controlling AI assistant behavior and response style 🔧 Improvements File Search Performance Optimization: Added search result deduplication and throttling mechanisms, significantly improving search response speed for large codebases Enhanced Large Repository Support: Added file and directory count limit protection mechanism to prevent memory issues in extremely large repositories Directory Browsing Optimization: Search results now prioritize displaying directories for quick location of project structure Error Message Display Improvements: Optimized diagnostic information for authentication errors to help locate and resolve issues faster Tool Control Optimization: Improved session level tool disabling mechanism, providing more granular feature control 🐛 Bug Fixes Streaming Response Handling Fix: Fixed exception handling when response is empty, improving error message accuracy MCP Permission Batch Settings: Support for wildcard syntax to approve all tools of a server at once, simplifying permission management process Multi line Input Navigation Fix: Corrected cursor positioning behavior of Home/End keys during multi line text input Editor Error Prompt Optimization: Improved error prompt logic when external editor fails to open Search Timeout Optimization: File search timeout adjusted to 30 seconds to prevent zombie processes from consuming system resources"},{"id":"/cli/release-notes/v2.25.0","title":"🚀 CodeBuddy Code v2.25.0 Release","body":"🚀 CodeBuddy Code v2.25.0 Release ✨ New Features Plan Mode Tool: Agent can proactively enter planning phase before executing complex tasks, helping you better understand and confirm the execution plan Enhanced Model Support: Added support for more powerful reasoning models, providing longer context windows and stronger reasoning capabilities 🔧 Improvements Enhanced Error Diagnostics: Provides more detailed error messages on authentication failures to help quickly locate and resolve issues; optimized request tracing functionality for easier troubleshooting of complete request chains MCP Tool Permission Management: Support for saving tool permission settings at the project level. Using the \"Don't ask again\" option now applies across the entire project, improving multi project workflow efficiency Agent Panel Optimization: More clearly displays different types of Agents; improved command search ranking algorithm to help you find desired commands faster; expanded external editor support range with better error prompts Input Experience Improvements: Optimized responsiveness and smoothness of input prompt box; improved display effects of reverse search functionality to enhance interaction experience 🐛 Bug Fixes Session Context: Fixed context passing issues in agent service to ensure conversation information is correctly preserved and passed Large File Reading: Added token count check for file reading to avoid errors caused by exceeding model context limits when reading extremely large log files"},{"id":"/cli/release-notes/v2.24.0","title":"🚀 CodeBuddy Code v2.24.0 Release","body":"🚀 CodeBuddy Code v2.24.0 Release ✨ New Features Built in Plugin Marketplace: Support for pre configured official recommended plugin marketplace through product configuration, with automatic installation on startup, making it easier for users to discover and use high quality plugins 🔧 Improvements Background Task Execution: Refactored task management module to improve the stability and reliability of background task execution Todo Item Experience: Optimized todo item status update mechanism to improve UI responsiveness 🐛 Bug Fixes Tool Permission Check: Fixed tool permission check failure in SDK mode to ensure tool invocation security External Editor Paste: Fixed text processing issues when pasting content from external editors, improving input experience Sub agent Tool Inheritance: Fixed tool inheritance logic in sub agent configuration to ensure correct default tool permissions are obtained Context Trimming Timing: Optimized conversation history trimming strategy to avoid errors caused by exceeding model context limits"},{"id":"/cli/release-notes/v2.23.5","title":"🚀 CodeBuddy Code v2.23.5 Release","body":"🚀 CodeBuddy Code v2.23.5 Release 🔧 Improvements & Optimizations Slash Command Permission Control: Support fine grained tool permission configuration for custom commands, enhancing command execution security and flexibility 🐛 Bug Fixes ACP Mode Permission Request: Fixed tool call permission request failure in ACP protocol mode, ensuring proper user authorization before tool execution Subagent Tool Access: Fixed subagent tool access failure when MCP server names contain special characters, improving multi agent collaboration stability Tool Permission Isolation: Optimized subagent tool permission management, ensuring each agent receives correct tool access permissions"},{"id":"/cli/release-notes/v2.23.0","title":"🚀 CodeBuddy Code v2.23.0 Release","body":"🚀 CodeBuddy Code v2.23.0 Release Release Date: 2025 12 22 ✨ New Features Agent SDK Permission Control Support: SDK now supports tool invocation permission management, allowing clients to approve or reject tool execution requests Agent SDK User Q&A Support: SDK now supports AskUserQuestion tool, enabling AI agents to ask users questions and gather feedback during execution 🚀 Performance Optimizations Significant @ File Search Performance Boost: Optimized file search experience in large repositories, resolving lag and crash issues caused by continuous input Implements single flight full enumeration: Only one runs per input round, avoiding redundant scans Background preloading of file lists: Uses useEffect to preload file lists during idle time, preventing first search freeze Only accepting latest query results: Uses requestId mechanism to discard outdated requests, preventing result flickering and redundant calculations Reduced memory allocation: Fuzzy matching directly handles string arrays, generating objects only for top results Automatic cleanup on context exit: Clears scan sessions when leaving context, avoiding memory overhead 🐛 Bug Fixes Fixed First Search Freeze: Uses useEffect background preloading; if preloading incomplete on first query, loads asynchronously without blocking UI response Fixed Windows Path Matching Accuracy: Ensures all paths are unified to POSIX style separators before processing, avoiding split failures Fixed execRg Timer Leak: Ensures timeout timers are properly cleaned up on all exit paths Upgrade Notes This release focuses on optimizing file search performance, especially when using symbol for file search in large codebases. If you frequently work with large projects, you'll notice significant improvements in search response speed and stability after upgrading. Technical Details File Search Architecture Optimization To address large repository performance issues, this release includes a comprehensive refactoring of the file search me"},{"id":"/cli/release-notes/v2.23.4","title":"🚀 CodeBuddy Code v2.23.4 Release","body":"🚀 CodeBuddy Code v2.23.4 Release 🔧 Improvements Context Statistics Enhancement: The command now displays token usage for MCP tools, helping users better understand context usage details UI Rendering Optimization: Improved terminal UI rendering performance and display stability, enhanced session state handling reliability 🐛 Bug Fixes Fixed First Login Issue: Resolved the issue where API Key authentication failed on first use Credential Validation Enhancement: Added credential existence check, automatically falling back to alternative authentication methods when credential retrieval fails Path Resolution Improvement: Support for expansion in configuration paths, improving configuration convenience Streaming Output Optimization: Fixed duplicate message identifiers in streaming output Session Recovery Stability: Enhanced null value checking to avoid runtime errors in specific scenarios Module Loading Optimization: Resolved circular dependency issues in product configuration management module"},{"id":"/cli/release-notes/v2.23.3","title":"🚀 CodeBuddy Code v2.23.3 Release","body":"🚀 CodeBuddy Code v2.23.3 Release 🔧 Improvements Stability Enhancement: Routine maintenance update to improve system stability"},{"id":"/cli/release-notes/v2.23.2","title":"🚀 CodeBuddy Code v2.23.2 Release","body":"🚀 CodeBuddy Code v2.23.2 Release ✨ New Features Model Support Expansion: Added support for GLM 4.7 model, providing users with more model options"},{"id":"/cli/release-notes/v2.22.0","title":"🚀 CodeBuddy Code v2.22.0 Release","body":"🚀 CodeBuddy Code v2.22.0 Release ✨ New Features SDK integration enhancement: Added bidirectional communication capability between SDK and CLI, supporting control signal transmission Flexible permission control: SDK can take over tool execution permissions to implement custom permission policies Hook system extension: Support SDK registration of tool execution hooks to implement custom interception and processing logic 🔧 Improvements UI experience enhancement: Optimized terminal loading box display for improved visual presentation and interactive experience 🐛 Bug Fixes Output compatibility enhancement: Fixed terminal control sequence interference with JSON output in SDK and pipeline mode to ensure correct data format Search accuracy improvement: Improved file ignore rule matching logic to enhance file search accuracy"},{"id":"/cli/release-notes/v2.21.0","title":"🚀 CodeBuddy Code v2.21.0 Release","body":"🚀 CodeBuddy Code v2.21.0 Release ✨ New Features New model support: Added GPT 5.2 model, providing you with more powerful reasoning capabilities and smarter code assistance 🔧 Improvements Loading status optimization: Improved display of terminal loading prompts to make the waiting process clearer and more intuitive 🐛 Bug Fixes Command execution stability: Fixed potential process hanging issues during subprocess calls to improve command execution reliability"},{"id":"/cli/release-notes/v2.20.1","title":"🚀 CodeBuddy Code v2.20.1 Release","body":"🚀 CodeBuddy Code v2.20.1 Release 🐛 Bug Fixes CLI mode detection optimization: Fixed output display issues for non interactive commands (such as install, update) in terminal First time installation compatibility: Fixed path detection failure during initial binary installation, ensuring a smoother first time installation experience Image content transfer: Fixed conversion handling of image content in streaming output to ensure correct image data display 🔧 Improvements Task progress display: Optimized visual effects of task progress bars to show task execution status more clearly Tool loading enhancement: Improved loading timing of dynamic tools to ensure sub agents can properly use all available tools Session management stability: Enhanced stability and performance of session lifecycle management Input interaction experience: Improved terminal input handling for a more stable interactive experience Connection reliability: Optimized protocol communication logic to improve connection stability"},{"id":"/cli/release-notes/v2.20.0","title":"🚀 CodeBuddy Code v2.20.0 Release","body":"🚀 CodeBuddy Code v2.20.0 Release ✨ New Features Usage Statistics Command: New command to easily view your usage metrics, including token consumption, session duration, model invocation counts, and other core data Multi dimensional Statistics View: Support for viewing usage by model category, with flexible switching between 7 day, 30 day, and all time ranges Visual Charts: Intuitive ASCII bar charts that clearly display usage distribution across different models 🔧 Improvements & Optimizations Session Management Enhancement: Optimized storage and cleanup mechanisms for session history, improving stability and reliability of session management Interactive Experience Improvement: Enhanced interaction experience for confirmation dialogs, input prompts, and session panels, making operations smoother and more convenient Keyboard Operation Optimization: Improved response stability and accuracy of keyboard shortcuts, boosting operational efficiency Installation Detection Improvement: Enhanced accuracy of installation method detection across different environments, reducing environment related issues Agent Framework Upgrade: Updated OpenAI agents SDK to the latest version, improving overall stability and performance 🐛 Bug Fixes Context Display Issue: Fixed issue where buffer information was still displayed when autocompact was disabled; display logic now behaves as expected Linux Compatibility: Resolved dynamic library loading errors that could occur when starting on older Linux systems Theme Display Optimization: Corrected theme color display in colorblind mode, improving visual experience Response Completeness: Ensured that result messages are always returned when tasks complete, preventing clients from being unable to exit properly Error Message Enhancement: Improved error logging with more detailed debugging information for easier troubleshooting"},{"id":"/cli/release-notes/v2.19.2","title":"🚀 CodeBuddy Code v2.19.2 Release","body":"🚀 CodeBuddy Code v2.19.2 Release 🔧 Improvements Conversation history management: Improved conversation history management efficiency, optimized memory usage, and support for longer conversation sessions Session state management: Optimized session state management logic, improving responsiveness and stability when switching between multiple sessions Code robustness: Enhanced internal type definitions, improving type safety and code maintainability Extension system enhancement: Improved hook execution mechanism before and after tool calls, providing better extensibility for plugin development Message display optimization: Optimized the organization and display logic of conversation messages, improving interaction experience fluency New visual theme: Adopted a new brand green color scheme, enhancing product visual identity Logo design upgrade: Optimized terminal logo display with a clean and refreshing robot avatar style"},{"id":"/cli/release-notes/v2.19.1","title":"🚀 CodeBuddy Code v2.19.1 Release","body":"🚀 CodeBuddy Code v2.19.1 Release 🔧 Improvements & Optimizations ACP Protocol Optimization: Enhanced command filtering mechanism and output display, improving protocol compatibility and interface clarity Image Reading Support: Read tool now supports directly reading and displaying image files, enabling richer file handling scenarios Interface Loading Optimization: Simplified session loading state management, improving interface responsiveness and stability 🐛 Bug Fixes Tool Approval Interface: Fixed incomplete information display issue in ACP protocol mode approval interface, improving readability Hook Integration Mechanism: Improved tool execution Hook invocation to ensure custom scripts can properly handle tool parameters Exit Process Enhancement: Fixed issue where session events were not properly triggered during CLI exit Terminal Compatibility: Fixed compatibility issues when pasting large amounts of text in some Windows and Linux terminals"},{"id":"/cli/release-notes/v2.19.0","title":"🚀 CodeBuddy Code v2.19.0 Release","body":"🚀 CodeBuddy Code v2.19.0 Release ✨ New Features Session Rename: Added command for quickly renaming the current session, supporting both direct argument passing and interactive panel operation Input Undo: Added keyboard shortcut support to undo text edits in the input box at any time 🔧 Improvements & Optimizations Session Resume Panel: Optimized the session resume interface for a more intuitive session management experience Connection Diagnostics Enhancement: Improved diagnostic information for network disconnection scenarios to facilitate troubleshooting"},{"id":"/cli/release-notes/v2.18.0","title":"🚀 CodeBuddy Code v2.18.0 Release","body":"🚀 CodeBuddy Code v2.18.0 Release ✨ New Features API Key Caching Support: Improves credential management response speed and efficiency, reducing wait times for frequent authentication. Supports custom cache refresh interval via environment variable 🔧 Improvements UI Performance Optimization: Reduces unnecessary interface re rendering, improving interaction fluency Paste Functionality Enhancement: Improves text paste processing speed and stability Command Display Optimization: Intelligently controls command metadata length, improving performance in long prompt scenarios Model Selection Update: Expands available model list, providing more options 🐛 Bug Fixes MCP OAuth Authentication Flow Fix: Resolves the issue requiring manual reconnection after authorization, improving authentication experience Terminal Compatibility Improvement: Fixes code highlighting display issues in tmux environments"},{"id":"/cli/release-notes/v2.17.0","title":"🚀 CodeBuddy Code v2.17.0 Release","body":"🚀 CodeBuddy Code v2.17.0 Release ✨ New Features IDE Integration Enhancement: Added IDE diff confirmation view and interactive panel, supporting intuitive code change review in IDE Smart Confirmation Flow: Introduced IDE confirmation service and interceptors, improving tool call security and user experience Terminal Title Auto update: CLI intelligently updates terminal title based on conversation context, helping users quickly identify work content across multiple terminal windows Windows Terminal Keyboard Enhancement: Improved keyboard input handling for Windows terminal, enhanced multi line editing support. Added Windows Terminal auto configuration feature, supporting Shift+Enter line break shortcut 🔧 Improvements & Optimizations Tool Call Interface Optimization: Improved display of file reading and search tools, providing clearer information presentation Permission Management Enhancement: Added explicit permission confirmation flow for file operation tools, improving security Search Experience Optimization: Improved permission checking mechanism for file search tools, providing smoother experience in trusted directories Interface Interaction Improvement: Enhanced multi select and input component interaction experience in terminal interface Shortcut Key Adjustment: Changed expand detailed record shortcut from Ctrl+R to Ctrl+O, avoiding conflict with terminal reverse search function History Message Display Optimization: Improved display of conversation records, providing clearer viewing experience Update Notification Improvement: Optimized version update notification display mechanism, improving stability 🐛 Bug Fixes ACP Protocol Compatibility: Fixed issue where sessions were incorrectly terminated in ACP mode, ensuring normal message stream transmission Custom Model Loading: Improved configuration file read error handling, improving custom model loading stability Message Display Fix: Fixed issue where incomplete messages from history conversations appeared repea"},{"id":"/cli/release-notes/v2.16.0","title":"CodeBuddy Code v2.16.0 Release","body":"CodeBuddy Code v2.16.0 Release ✨ New Features Input History Reverse Search: Support for shortcut to perform interactive search in command history, quickly locate and reuse previous input content 🔧 Improvements Input Experience Upgrade: Refactored input box state management for improved response speed and interaction fluidity Paste Function Optimization: Enhanced clipboard paste experience with better handling of images and large text content Command Quick Settings: command now supports direct input of model ID for quick switching Intelligent Update Strategy: Automatically selects the optimal update method based on package manager Complete Diagnostic Information: Doctor panel displays auto update status and package manager information 🐛 Bug Fixes Fixed issue where terminal output interfered with communication in ACP mode Fixed abnormal state after deleting keywords in reverse search Fixed incomplete message passing in sub agents Fixed potential exceptions during command execution"},{"id":"/cli/release-notes/v2.15.1","title":"CodeBuddy Code v2.15.1 Release","body":"CodeBuddy Code v2.15.1 Release 🔧 Improvements Message Debugging Enhancement: Added timestamp field to streaming output for easier debugging and performance analysis Code Architecture Optimization: Improved message processing logic structure for better code maintainability and reusability Vim Mode Operation Optimization: Improved word movement logic for more accurate and smoother cursor navigation 🐛 Bug Fixes State Management Optimization: Fixed issue where user interrupt state was overwritten by asynchronous events, ensuring interrupt state is correctly maintained"},{"id":"/cli/release-notes/v2.15.0","title":"🚀 CodeBuddy Code v2.15.0 Release","body":"🚀 CodeBuddy Code v2.15.0 Release ✨ New Features Terminal Notification System: When the terminal is running in the background, system notifications will be sent to remind you to check the results after the AI assistant completes a task 🔧 Improvements Proxy Configuration Enhancement: Support for NOPROXY environment variable to specify which domains should bypass the proxy Vim Mode Navigation Optimization: Improved accuracy of the command for smoother word to word navigation Diagnostic Panel Optimization: Clearer settings information display with summary view for complex configurations TODO Tool Enhancement: More stable task list parsing with better error tolerance 🐛 Bug Fixes Sub agent Execution Stability: Fixed potential response interruption issues when executing multiple sub agents consecutively Security Update: Fixed critical security vulnerabilities in dependency packages to improve overall security /clear Command Improvement: Permission mode settings are no longer accidentally reset after using the clear screen command"},{"id":"/cli/release-notes/v2.14.1","title":"🚀 CodeBuddy Code v2.14.1 Release","body":"🚀 CodeBuddy Code v2.14.1 Release 🔧 Improvements CLI Interactive Experience Optimization: Improved command line interface interaction flow and user feedback mechanism for smoother operations Session Management Enhancement: Improved stability and responsiveness of session interruption handling, reducing the impact of unexpected interruptions Vim Mode Refinement: Optimized keyboard operations and context management in Vim mode for a smoother editing experience Tool Execution Optimization: Improved performance and accuracy of tool invocation and result processing for faster task response"},{"id":"/cli/release-notes/v2.14.0","title":"CodeBuddy Code v2.14.0 Release","body":"CodeBuddy Code v2.14.0 Release ✨ New Features Vim Editor Mode: Added Vim style editing support with NORMAL and INSERT mode switching, supporting standard Vim navigation and editing commands, providing a familiar editing experience for Vim users IDE Selection Interaction: Added command with visual interface for selecting and managing IDE connections, making multi IDE collaboration scenarios more convenient 🔧 Improvements Terminal Emulation Optimization: Improved terminal emulation module under Bun runtime for better compatibility Windows Chinese Display Enhancement: Improved character encoding handling for command output, enhancing Chinese display compatibility on Windows platform Third party Service Compatibility Enhancement: Improved runtime polyfill mechanism to enhance compatibility with third party services Error Handling Enhancement: Improved log refresh mechanism safety to avoid errors when service is not initialized IDE Detection Enhancement: Improved terminal environment recognition logic to enhance IDE integration stability Environment Variable Handling Optimization: Improved boolean value parsing logic for environment variable to enhance configuration accuracy 🐛 Bug Fixes Command Execution Optimization: Normalized system command execution parameters to prevent unexpected output interfering with normal flow IDE Context Cleanup: Fixed issue where selection content remained after IDE disconnection, ensuring session context is properly reset Concurrent Tool State Fix: Fixed state transition issues when multiple tools execute concurrently Message Deduplication Optimization: Fixed UI display issues caused by duplicate message group additions"},{"id":"/cli/release-notes/v2.13.0","title":"🚀 CodeBuddy Code v2.13.0 Release","body":"🚀 CodeBuddy Code v2.13.0 Release ✨ New Features Token Analysis Command: Added command to view token usage distribution across modules in the current session, helping understand context consumption IDE Auto Connect: CLI automatically detects and establishes communication with local IDE on startup, with real time connection status displayed in the status bar Ripgrep Configuration Option: Added environment variable to choose between system installed ripgrep or the built in version 🔧 Improvements Loading Interface Optimization: Improved display style of tool call results and loading prompts for better visual experience Model Output Configuration: Support for dynamically adjusting model output limits via environment variables Skill Loading Acceleration: Optimized skill scanning mechanism to improve startup speed Enhanced Shell Compatibility: Improved default shell configuration for better cross platform stability 🐛 Bug Fixes Command Execution Feedback: Fixed missing running status prompt when executing custom commands IDE File Prompt: Improved file open prompt logic to correctly display prompts even when no content is selected Encoding Detection Optimization: Improved system encoding detection mechanism to avoid error output interference"},{"id":"/cli/release-notes/v2.12.0","title":"🚀 CodeBuddy Code v2.12.0 Release","body":"🚀 CodeBuddy Code v2.12.0 Release ✨ New Features Standalone Theme Selection Panel: Added command with an interactive theme selection panel, supporting multiple theme variants including dark, light, colorblind friendly, ANSI, and more Real time Theme Preview: Preview different themes in real time within the theme panel to easily find the color scheme that suits you User Feedback Survey: Added user experience feedback survey functionality to help us better understand your usage experience Output Style Management: Support for customizing AI response output formats to meet personalized needs 🔧 Improvements Theme System Refactoring: Standalone theme management panel provides a more professional configuration experience Enhanced Terminal Compatibility: Improved recognition and support for older iTerm terminal versions Enhanced File Search: Support for searching hidden files and directories, never miss important configuration files again Build Optimization: Improved application startup speed for more responsive performance Feedback Survey Optimization: Enhanced responsiveness and user experience of feedback components 🐛 Bug Fixes Error Retry Optimization: Improved recognition mechanism for context too long errors, reducing unnecessary retries and enhancing conversation stability Skill Configuration Parsing: Fixed issue with multi line text parsing failures in skill configuration files"},{"id":"/cli/release-notes/v2.11.0","title":"🚀 CodeBuddy Code v2.11.0 Release","body":"🚀 CodeBuddy Code v2.11.0 Release ✨ New Features Sub agent Model Selection: Support dynamic model selection when invoking sub tasks, allowing flexible adjustment based on task complexity to optimize cost and performance Sub agent Session Resume: Support resuming previous sub task sessions based on existing context, suitable for staged analysis and iterative optimization scenarios 🔧 Improvements Project level Conversation Memory Enhancement: Support cascading loading of CODEBUDDY.md files from parent directories, automatically inheriting project context Interactive Command Support Enhancement: Improved interactive handling capabilities for terminal commands, enhancing execution stability and user experience Terminal Display Optimization: Enhanced color and format preservation in terminal output, improving visual experience Exit Experience Optimization: Improved double ESC exit logic with increased timeout and visual feedback prompts Conversation Memory Optimization: Improved conversation history loading mechanism, enhancing context management efficiency Plugin Loading Stability Enhancement: Single command loading failure no longer affects normal usage of other commands Input Experience Optimization: Improved support for special characters and emojis, enhancing editing fluency 🐛 Bug Fixes Image Paste Fix: Fixed format recognition issue when pasting images, ensuring correct image upload Response Stability Enhancement: Fixed potential infinite retry loop issue when model output is extremely long Configuration Merge Fix: Fixed deduplication issue when merging configuration items, avoiding duplicate configuration entries Editor Interaction Fix: Resolved content handling exception when returning from external editor Plugin Path Fix: Fixed installation path recognition issue for local directory type plugins"},{"id":"/cli/release-notes/v2.10.1","title":"🚀 CodeBuddy Code v2.10.1 Release","body":"🚀 CodeBuddy Code v2.10.1 Release 🐛 Bug Fixes Keyboard Input Optimization: Improved terminal keyboard input handling logic, enhancing input response stability"},{"id":"/cli/release-notes/v2.10.0","title":"🚀 CodeBuddy Code v2.10.0 Release","body":"🚀 CodeBuddy Code v2.10.0 Release ✨ New Features Sandbox Management Command: Added slash command to quickly enable or disable sandbox protection mode for Bash commands 🔧 Improvements ACP Protocol Mode Optimization: Improved model information display in ACP mode, providing clearer runtime status Sandbox Architecture Upgrade: Optimized sandbox mechanism for Bash command execution, enhancing execution performance and system stability Terminal Interaction Enhancement: Improved keyboard input handling and command parsing, enhancing terminal response speed and input accuracy File Reference Experience Enhancement: Automatically display file name and size when referencing files using Startup Performance Optimization: Skip unnecessary initialization steps in non interactive mode, accelerating startup speed Configuration Query Optimization: Automatically merge multi level configurations and return final results for more convenient usage UI Performance Enhancement: Streamlined login interface components, optimizing rendering performance Permission Control Enhancement: Improved permission matching logic for Skill tool 🐛 Bug Fixes ACP Protocol Permission Request: Fixed issue where permission requests could not be properly triggered when sub tasks execute tools Debug Log Enhancement: Ensure debug logs are correctly written to corresponding session files Message Queue Stability: Fixed format issues during message processing, improving display stability Error Handling Enhancement: Improved fault tolerance when tool parameters are empty"},{"id":"/cli/release-notes/v2.9.0","title":"🚀 CodeBuddy Code v2.9.0 Release","body":"🚀 CodeBuddy Code v2.9.0 Release ✨ New Features Authentication Success Notification: Added Hook notification event after successful user login, supporting triggering custom scripts upon authentication completion to enable automated workflows after login"},{"id":"/cli/release-notes/v2.8.6","title":"🚀 CodeBuddy Code v2.8.6 Release","body":"🚀 CodeBuddy Code v2.8.6 Release 🔧 Improvements and Optimizations Enhanced Terminal Input Processing: Improved cross platform input parsing mechanism, enhancing terminal stability and compatibility Optimized Paste Experience: Refined large text paste handling with automatic paste mode recognition, improving text input convenience Message Processing Mechanism Optimization: Refactored internal message queue, improving conversation response speed and system stability Enhanced UI Rendering Performance: Optimized rendering efficiency of the main application interface and chat view, providing a smoother interactive experience Simplified Command Execution Flow: Optimized terminal command execution logic, improving execution efficiency 🐛 Bug Fixes Protocol Mode Configuration Persistence: Fixed issue where configuration was lost in multi turn conversations under client protocol mode, ensuring session stability tmux Clipboard Paste: Fixed issue where clipboard images could not be pasted in tmux terminal environment"},{"id":"/cli/release-notes/v2.8.5","title":"🚀 CodeBuddy Code v2.8.5 Release","body":"🚀 CodeBuddy Code v2.8.5 Release 📚 Documentation Enhancement GitLab CI/CD Integration Guide: Added comprehensive CI/CD integration documentation to help you easily use CodeBuddy Code in GitLab pipelines, including detailed configuration examples, usage scenarios, and common troubleshooting solutions"},{"id":"/cli/release-notes/v2.8.4","title":"🚀 CodeBuddy Code v2.8.4 Release","body":"🚀 CodeBuddy Code v2.8.4 Release 🔧 Improvements Type Definition Optimization: Improved code organization structure for enhanced long term maintenance efficiency 🐛 Bug Fixes Permission Mode Synchronization: Fixed an issue where permission settings were not properly applied during subtask execution, ensuring consistency in permission control for batch operations"},{"id":"/cli/release-notes/v2.8.3","title":"🚀 CodeBuddy Code v2.8.3 Release","body":"🚀 CodeBuddy Code v2.8.3 Release 🔧 Improvements and Optimizations Gemini Model Support Expansion: Added support for Gemini 3.0 Pro model, providing more powerful reasoning capabilities and larger context windows to handle more complex programming tasks Intelligent File Processing Optimization: Automatically identifies and skips reference processing for oversized files, effectively avoiding performance issues and improving response speed in large projects Code Architecture Stability Enhancement: Optimized middleware dependency injection mechanism, service initialization workflow, and session type definitions to improve system stability and code maintainability Session Management Experience Improvement: Enhanced data processing logic in the session recovery panel for a smoother session management experience Permission Control Reliability: Improved directory trust state management for more precise and reliable permission control 🐛 Bug Fixes Remote Execution Environment Connection Stability: Optimized authentication token handling mechanism to improve stability when connecting to sandboxes and remote execution environments Shell Command Compatibility: Enhanced command execution environment to support tools requiring terminal interaction, improving the success rate of various command executions"},{"id":"/cli/release-notes/v2.8.2","title":"🚀 CodeBuddy Code v2.8.2 Release","body":"🚀 CodeBuddy Code v2.8.2 Release 🔧 Improvements Conversation Context Enhancement: Improved conversation message processing mechanism to ensure complete contextual information is properly retained and passed through multi turn conversations, enhancing the coherence and accuracy of AI responses"},{"id":"/cli/release-notes/v2.8.1","title":"🚀 CodeBuddy Code v2.8.1 Release","body":"🚀 CodeBuddy Code v2.8.1 Release 🔧 Improvements and Optimizations Plan Mode Refactoring: Refactored Plan mode with an entirely new Sub Agent architecture, providing smarter and more stable task planning and execution capabilities Smart Model Image Detection: Automatically detects model image support capabilities and intelligently handles image input when the model doesn't support it, improving cross model usage fluency Runtime Environment Health Check: Automatically detects Node.js version at startup to proactively avoid environment compatibility issues and ensure stable tool operation ACP Protocol Experience Enhancement: Automatically pushes command list when creating sessions to support intelligent auto completion; optimized authentication methods to automatically recommend the best login options based on network environment Permission Command Risk Adjustment: Optimized risk classification strategy for privilege escalation commands like sudo/su, reducing unnecessary confirmations while maintaining security and improving efficiency 🐛 Bug Fixes Git Operation Security Enhancement: Improved dangerous command detection rules to more accurately identify and block high risk Git operations such as force push and branch deletion Windows Path Compatibility: Fixed case sensitivity issues with paths on Windows systems, improving stability of cross platform file operations Non Interactive Mode Tool Control: Fixed behavior logic of user question answer tool in non interactive mode to ensure smooth automated workflow execution Exclusive Edition Environment Adaptation: Fixed environment recognition issues in exclusive editions to ensure correct configuration loading Clipboard Detection Compatibility: Temporarily adjusted clipboard detection strategy to resolve false trigger issues in certain environments and improve user experience"},{"id":"/cli/release-notes/v2.8.0","title":"🚀 CodeBuddy Code v2.8.0 Release","body":"🚀 CodeBuddy Code v2.8.0 Release ✨ New Features Native Editor Integration: Supports deep integration with editors like Zed through the ACP protocol, delivering a more seamless AI assisted development experience Intelligent Security Protection: Introduces a five level command risk classification system covering 9 major categories including file operations, Git management, container control, etc. High risk operations are automatically intercepted for confirmation, making AI automation more secure 🔧 Improvements and Optimizations Intelligent Dangerous Operation Recognition: Optimized risk assessment strategy to automatically identify Git operations that may cause data loss and elevate their risk level, with stricter protection for main branches Security Mode Enhancement: Improved security checks for permission bypass mode, requiring confirmation for extremely high risk operations in interactive scenarios, balancing automation and security Visual Prompt Upgrade: High risk command confirmation interface uses warning colors for highlighting, making potential dangerous operations immediately recognizable Document Parsing Efficiency Improvement: Optimized Markdown file processing performance for faster loading speed 🐛 Bug Fixes Security Approval Mechanism Reinforcement: Fixed vulnerability where high risk commands could potentially skip confirmation, ensuring all dangerous operations require user authorization Prompt Template Optimization: Eliminated duplicate content in system prompts to improve AI response accuracy"},{"id":"/cli/release-notes/v2.7.0","title":"🚀 CodeBuddy Code v2.7.0 Release","body":"🚀 CodeBuddy Code v2.7.0 Release ✨ New Features Token Counter Display Control: Added display toggle setting, allowing users to choose whether to show or hide Token usage statistics based on personal preference 🔧 Improvements and Optimizations Session Identifier Rule Optimization: Relaxed format restrictions for session IDs, supporting more flexible custom session identifiers Statistics Accuracy Improvement: Enhanced statistical logic for tool execution status to ensure accuracy of usage data 🐛 Bug Fixes Message Processing Reliability Enhancement: Strengthened message type validation mechanism to avoid processing exceptions caused by invalid data Error Feedback Mechanism Optimization: Improved exception information delivery process to provide clearer error messages Theme Adaptation Experience Optimization: Optimized color display algorithm to automatically adapt to dark and light themes, improving visual comfort"},{"id":"/cli/release-notes/v2.6.1","title":"🚀 CodeBuddy Code v2.6.1 Release","body":"🚀 CodeBuddy Code v2.6.1 Release 🔧 Improvements and Optimizations Error Handling Enhancement: Improved server side request error handling mechanism, enhancing the accuracy and readability of error messages for more efficient issue troubleshooting 🐛 Bug Fixes Image Paste Optimization: Optimized clipboard image reading mechanism, improved multi file paste support, and enhanced the stability and reliability of image pasting Plugin Marketplace Deduplication: Fixed the issue where duplicate entries might appear when loading the plugin marketplace. Now automatically filters marketplaces with the same name and source, improving interface cleanliness"},{"id":"/cli/release-notes/v2.6.0","title":"🚀 CodeBuddy Code v2.6.0 Release","body":"🚀 CodeBuddy Code v2.6.0 Release ✨ New Features GPT 5.1 Series Models: Added three new model options GPT 5.1, GPT 5.1 codex, and GPT 5.1 codex mini, offering larger context windows (supporting up to 272K tokens input) and enhanced reasoning capabilities, perfect for complex code analysis and long document tasks"},{"id":"/cli/release-notes/v2.5.0","title":"🚀 CodeBuddy Code v2.5.0 Release","body":"🚀 CodeBuddy Code v2.5.0 Release ✨ New Features Session Branch Management: Support creating new branches when resuming sessions, helping you better organize and manage different conversation topics Message Replay Confirmation: Automatically echo your input in non interactive mode to ensure you can double check commands before execution Custom Agent Configuration: Define your own AI assistant behaviors and capabilities through configuration files System Prompt Customization: Support customizing or extending system prompts to make the AI assistant better fit your workflow Settings Loading Control: Flexibly specify which sources to load configuration from (user level/project level/temporary settings) to meet different scenario needs External Configuration Import: Support loading additional settings from files or JSON strings for easy configuration sharing and reuse 🔧 Improvements & Optimizations More Flexible Command Execution: Customize Bash command timeout and output length via environment variables to adapt to different task requirements Verbose Logging Mode: Added verbose output switch to help you understand the AI assistant's execution process in depth Enhanced Streaming Messages: Support viewing complete incremental messages in streaming output mode, providing more transparent execution feedback Beautified Cost Statistics: Improved display format of usage cost statistics with better alignment for clearer readability Optimized Configuration Loading: Added product configuration caching mechanism to improve startup speed and runtime performance 🐛 Bug Fixes MCP Server Interaction Optimization: Resolved blocking issues caused by MCP server approval in non interactive mode; now supports pre configuring approval free servers Improved Terminal Compatibility: Fixed paste mode anomalies and ESC key delay issues in some terminal environments for smoother input experience Update Service Stability: Optimized automatic update check mechanism to avoid duplicate installations "},{"id":"/cli/release-notes/v2.4.0","title":"🚀 CodeBuddy Code v2.4.0 Release","body":"🚀 CodeBuddy Code v2.4.0 Release ✨ New Features Task Execution Turn Control: Added command line parameter, allowing you to precisely control the AI assistant's execution turns, avoiding infinite loops and improving task execution controllability 🔧 Improvements Execution Capability Enhancement: Default maximum execution turns increased from 100 to 500, providing more processing capacity for complex tasks and reducing task interruptions caused by turn limits External Editor Integration: Added Ctrl+G shortcut support for quickly invoking external editors like VSCode or Sublime Text to edit long text, improving input experience Log Saving Optimization: Improved log persistence mechanism to ensure all log information is completely saved when the process exits, facilitating troubleshooting Session Management Optimization: Improved historical session list display by automatically filtering internal sub agent sessions, making the session list clearer 🐛 Bug Fixes Native Version Command Compatibility: Fixed the issue where the command could not run properly in Native environment Telemetry Data Accuracy: Fixed the missing identification information in tool invocation telemetry data to ensure complete data reporting Auto update Stability: Enhanced the auto update lock mechanism in multi process scenarios to avoid update conflicts Sub agent Interruption Issue: Fixed the issue where sub agents could not respond to interrupt commands, improving interactive experience"},{"id":"/cli/release-notes/v2.3.1","title":"🚀 CodeBuddy Code v2.3.1 Release","body":"🚀 CodeBuddy Code v2.3.1 Release 🔧 Improvements File Editing Stability: Optimized string replacement logic to improve accuracy and reliability when handling special characters Plugin Marketplace Experience: Improved plugin source recognition capability and provided more friendly error messages, lowering configuration barriers Skills Debugging Experience: Optimized skill loading log output to display skill sources more clearly, facilitating troubleshooting Tool System Flexibility: Support for dynamically controlling tool availability based on runtime environment, improving system adaptability Command Input Efficiency: Improved slash command auto completion with exact match priority display to speed up command input Interface Rendering Performance: Optimized list component key attribute strategy to improve terminal interface stability and fluidity Image Paste Compatibility: Enhanced cmd+v image paste functionality with improved Windows system compatibility Configuration Interface Professionalism: Optimized prompt text in Hooks configuration panel to enhance product quality 🐛 Bug Fixes Hooks Documentation Improvement: Updated Hooks usage guide with improved documentation structure and examples to simplify configuration"}]
+[{"id":"/cli/overview","title":"Overview","body":"Overview Tencent Cloud Intelligent Coding Assistant Making Code Development Smarter and More Efficient CodeBuddy Code is an intelligent programming tool based on Tencent Cloud AI technology, deeply integrated with the Tencent Cloud ecosystem, providing full link AI assistance from code writing to project deployment. Why Choose CodeBuddy Code? 🚀 Drive the Entire DevOps Lifecycle with Natural Language CodeBuddy Code enables you to describe requirements in natural language and automate full link development tasks from code writing, testing, debugging, to deployment, achieving extreme automation efficiency. Whether it's a simple code modification or a complex architecture refactoring, it can be easily accomplished through conversational interaction. 🔧 Native Terminal, Seamless Integration Familiar Environment: Get AI assistance directly in your familiar command line environment, without switching development tools or learning new interfaces. Native Experience: Perfectly integrates into your existing development workflow, supporting all mainstream operating systems and terminals. Zero Learning Curve: Maintain your original development habits, with the AI assistant working silently in the background. ⚡ Powerful Out of the Box Capabilities Built in Toolchain: Integrates core development tools such as file editing, command execution, Git operations, and test execution. Intelligent Commits: Automatically generates standardized commit messages, supporting code review and change management. Flexible Expansion: Easily integrate third party tools and services through MCP (Model Context Protocol). Custom Development Tools: Customize exclusive development assistants based on project needs. 🛠️ AI Integration with Unix Philosophy Pipe Friendly: Like and , it natively supports pipe input for intelligent analysis. Script Integration: Perfectly integrates into shell scripts and automation toolchains. Compositional Capabilities: Seamlessly combines with existing Unix tools to build p"},{"id":"/cli/quickstart","title":"Quick Start Guide","body":"Quick Start Guide Welcome to CodeBuddy Code! This guide will help you get started in 5 minutes and experience a natural language driven programming assistant. 🎯 Before You Begin System Requirements Node.js: Version 18.20 or higher Operating System: macOS, Linux, or Windows Verify Your Environment ⚡ Quick Installation npm Global Installation Native Installer (Beta) ⚠️ Beta Feature: The native installer is currently in Beta. We recommend you try it to get a faster, standalone installation experience. The native installer provides an independent CodeBuddy installation without requiring a Node.js environment. Download and Install: Advantages: ✅ No Node.js dependency required ✅ Faster installation and startup Verify Installation 🔐 Login Authentication When using CodeBuddy Code for the first time, you need to complete login authentication. After startup, you will see the login method selection screen: Login Methods Login Method Use Case Description Chinese Site Users in China Authenticate via Tencent Cloud China (copilot.tencent.com), supports domestic mainstream models International Site Overseas users Authenticate via Tencent Cloud International (codebuddy.ai), supports international mainstream models Enterprise Domain Dedicated/Private deployment Connect to enterprise dedicated or self hosted CodeBuddy service, requires enterprise provided service address iOA Tencent employees Authenticate via Tencent iOA zero trust system, for Tencent internal employees only Use keys to select the login method, press to confirm, and the browser will automatically open to complete authentication. 🚀 First Experience 1. Navigate to Your Project Directory 2. Launch Interactive Mode You will see the welcome screen: Tip: If you want CodeBuddy Code to always reply in a specific language (e.g., Simplified Chinese), you can run the command after startup to set the Language option. 3. Initialize Project Context (Highly Recommended) Before starting your conversation, it is highly recommended "},{"id":"/cli/installation","title":"CodeBuddy Code Installation Guide","body":"CodeBuddy Code Installation Guide 📋 Table of Contents Installation Methods 📦 Install via Package Manager Node.js Package Managers Prerequisites: Node.js 18.20 or higher Choose your preferred package manager and run the following command: ::: code group ::: Homebrew (macOS/Linux) No Node.js required, install directly: ::: code group ::: Verify Installation After installation, run the following command to verify successful installation: ⚙️ Install via Native Binary (Beta) ⚠️ Beta Testing Phase Native binary installation is currently in Beta testing phase, and features are still being improved. If you encounter any issues, please submit an issue report on the , or contact technical support (codebuddy@tencent.com). Features Native binary installation provides the following features compared to the npm version: Single executable file with no additional dependencies No Node.js runtime required Improved automatic update mechanism Supported Platforms macOS (Apple Silicon M1/M2/M3 or Intel x8664) Linux (arm64 or x8664) Windows (x8664) Migrating from npm Version If you have already installed CodeBuddy Code via npm, you can migrate to the native binary version using the following command: Fresh Installation ::: code group ::: Verify Installation The installation script will automatically download the latest version and configure environment variables. After installation, run the following command to verify: If the command is not available, manually add the installation path to the environment variable: ::: code group ::: 🔄 Updates Automatic Updates CodeBuddy Code automatically stays up to date by default to ensure you have the latest features and security fixes. Disable Automatic Updates To disable automatic updates, set the environment variable: Manual Updates Use the following command to manually update to the latest version: The command will automatically detect your installation method and perform the corresponding update operation. Update via Package Manager If the com"},{"id":"/cli/common-workflows","title":"Common Workflows","body":"Common Workflows Learn common workflows for CodeBuddy Code. Each task in this document includes clear instructions, example commands, and best practices to help you get the most out of CodeBuddy Code. Understanding a New Codebase Getting a Quick Overview of the Codebase Suppose you've just joined a new project and need to quickly understand its structure. Steps: 1. Navigate to the project root directory 2. Start CodeBuddy Code 3. Ask for a high level overview 4. Dive into specific components Best Practices: Start with macro level questions, then narrow down to specific areas Ask about coding conventions and patterns used in the project Request a glossary of project specific terminology Finding Relevant Code Suppose you need to locate code related to a specific feature. Steps: 1. Ask CodeBuddy to find relevant files 2. Understand how components interact 3. Understand the execution flow Best Practices: Be specific about what you're looking for Use domain language from the project Refactoring Code Suppose you need to update legacy code to use modern patterns and practices. Steps: 1. Identify legacy code that needs refactoring 2. Get refactoring suggestions 3. Apply changes safely 4. Verify the refactoring Best Practices: Ask CodeBuddy to explain the benefits of modern approaches Request that changes maintain backward compatibility when needed Refactor in small, testable increments Using Plan Mode for Safe Code Analysis Plan mode instructs CodeBuddy to create a plan by analyzing the codebase through read only operations, perfect for exploring codebases, planning complex changes, or safely reviewing code. When to Use Plan Mode Multi step implementation: When your feature requires editing many files Code exploration: When you want to thoroughly research the codebase before changing anything Interactive development: When you want to iterate with CodeBuddy on the direction How to Use Plan Mode Enable plan mode during a session You can toggle to plan mode during a session us"},{"id":"/cli/interactive-mode","title":"Interactive Mode","body":"Interactive Mode Complete keyboard shortcuts, input modes, and interactive features reference for CodeBuddy Code interactive sessions. Keyboard Shortcuts <Note Keyboard shortcuts may vary by platform and terminal. Type a question mark in an interactive session to see the shortcuts available in your environment. </Note General Controls Shortcut Description Context CodeBuddy Support : : : : Cancel current input or generation Standard interrupt ✅ Supported Exit CodeBuddy Code session (when input box is empty and no conversation in progress) EOF signal, press twice to exit ✅ Supported Clear terminal screen Preserves conversation history ✅ Supported Toggle verbose output Display detailed tool usage and execution information ✅ Supported Reverse search command history Interactive search of previous commands ✅ Supported (macOS/Linux) or (Windows) Paste image from clipboard Paste image or image file path ✅ Supported Navigate command history Recall previous inputs ✅ Supported + Rewind code/conversation Restore code and/or conversation to previous state (requires pressing ESC twice consecutively when the input box is empty) ✅ Supported Toggle thinking mode Switch between thinking on and thinking off ✅ Supported (macOS/Linux) or (Windows) Toggle permission mode Switch between auto accept, plan, and normal modes ✅ Supported (macOS) or (Windows/Linux) Switch model Quickly open model selection panel ✅ Supported Notes: + rewind functionality is now supported: when the input box is empty, pressing the ESC key twice consecutively activates the feature, allowing you to quickly revert code or conversation to a previous state key in CodeBuddy Code is primarily used for auto completion, with partial support for thinking mode toggle (macOS/Linux) or (Windows) is used to toggle permission modes, including normal mode, auto accept edits mode, skip permissions mode, and plan mode. Note: On Windows, you must use ; does not work Multi line Input Method Shortcut Context CodeBuddy Support : : : "},{"id":"/cli/headless","title":"Headless Mode","body":"Headless Mode Run CodeBuddy Code programmatically without an interactive UI Overview Headless mode allows you to run CodeBuddy Code programmatically through command line scripts and automation tools without any interactive UI. Headless mode also supports scheduled task capabilities. In script, SDK, or server side integration scenarios, you can use tools such as , , and to create, view, and cancel scheduled tasks. ⚠️ Important Note: (or ) is a required parameter for non interactive mode. When using the parameter for non interactive execution, this parameter must be added to perform operations that require authorization (file read/write, command execution, network requests, etc.), otherwise these operations will be blocked. Only use this parameter in trusted environments and explicit task scenarios. See for details. Basic Usage The primary command line interface for CodeBuddy Code is the (or ) command. Use the (or ) flag to run in non interactive mode and print the final result: Configuration Options Headless mode leverages all available CLI options in CodeBuddy Code. Here are key options for automation and scripting: Flag Description Example : : : , Run in non interactive mode Specify output format ( , , ) , Resume a conversation by session ID , Continue the most recent conversation Enable verbose logging Append to system prompt (only works with ) List of allowed tools, space separated or<br / <br / comma separated string <br / <br / List of disallowed tools, space separated or<br / <br / comma separated string <br / <br / Load additional settings configuration from a JSON file or JSON string Specify which settings sources to load (options: , , ) Load MCP servers from a JSON file MCP tool for handling permission prompts (only works with ) ❌ Not supported Note: The feature is currently not supported. For a complete list of CLI options and features, please refer to the documentation. Multi turn Conversations For multi turn conversations, you can resume a conversation o"},{"id":"/cli/troubleshooting","title":"Troubleshooting and Best Practices","body":"Troubleshooting and Best Practices This document covers common problem solutions and usage optimization tips. Common Issues Shared Quota CLI, CodeBuddy IDE, and CodeBuddy Plugin share the same account's resource quota. ESC Key Not Working in JetBrains IDE JetBrains terminal handles the ESC key differently. Use or instead. Action Standard Terminal JetBrains Terminal Exit/Cancel or Model Switching serve Mode Network Access Issues LAN IP Access Returns Symptom: After starting with , accessing via LAN IP (e.g., ) results in in the browser. Cause: The HTTP server listens on (loopback address) by default, accepting only local connections. When accessing via LAN IP, the request reaches the machine but is rejected by the service. Solution: Add the parameter at startup to listen on all network interfaces: Password authentication is automatically enabled when starting on a non loopback address. The password is visible in the console output. Verify Service Listening Status You can check if the service is listening correctly with: If showing — accepts local connections only If showing or — accepts all network connections Migrating from Claude Code Migration Content Directory/File Description Custom agents configuration Slash command definitions Skill definitions AI instructions and memory documents Option 1: Symbolic Links (Recommended) Share configuration; changes in one place take effect in both. Option 2: Copy Files Independent configuration; changes don't affect each other. One Click Plugin Skills Installation Skills from Claude Code plugins support one click installation and are automatically loaded after installation. Verify Migration Cost Optimization Core Principles Use to start a new session for new tasks Use to compress history for long conversations Use to reference files instead of pasting code Session Management Commands Command Function View token consumption Start a new session Compress history Resume a previous conversation Cost Comparison Approach Input Tokens "},{"id":"/cli/best-practices","title":"CodeBuddy Code Best Practices","body":"CodeBuddy Code Best Practices From configuring your environment to parallel scaling, master the techniques and patterns that make CodeBuddy Code work at its best. CodeBuddy Code is an intelligent programming environment. Unlike traditional Q&A assistants, CodeBuddy can read files, execute commands, modify code, and autonomously solve problems while you observe, guide, or step away. This changes how you work. Instead of writing code yourself and asking for review, you describe goals and let CodeBuddy explore, plan, and implement. This guide covers patterns that have proven effective across various codebases, languages, and environments. Give CodeBuddy Ways to Verify Its Work Core Advice: Provide tests, screenshots, or expected outputs so CodeBuddy can self check. This is the single practice that improves results the most. CodeBuddy performs significantly better when it can verify its own work—running tests, comparing screenshots, validating outputs. Without clear success criteria, it may produce results that look correct but don't actually work. You become the only feedback loop, and every mistake requires your attention. Strategy Before After Provide verification criteria \"Implement a function that validates emails\" \"Write a validateEmail function. Test cases: user@example.com returns true, invalid returns false, user@.com returns false. Run the tests after implementing\" Verify UI changes visually \"Make the dashboard look better\" \"[paste screenshot] Implement this design. After finishing, take a screenshot and compare with the original, list differences and fix them\" Address root causes \"Build is failing\" \"Build is failing, error message: [paste error]. Fix it and verify the build succeeds. Address the root cause, don't just suppress the error\" Verification can be a test suite, linter, or Bash command that checks output. Invest time to make verification reliable. Provide Specific Context in Prompts Core Advice: The more precise your instructions, the fewer correctio"},{"id":"/cli/settings","title":"Settings Configuration","body":"Settings Configuration CodeBuddy Code uses a layered configuration system that enables personalization at different levels, from personal preferences to team standards to project specific requirements. Configuration Files The file is the official mechanism for configuring CodeBuddy Code, supporting layered settings: User settings are defined in and apply to all projects Project settings are stored in the project directory: for settings checked into source control and shared with the team for settings not checked in, suitable for personal preferences and experiments. CodeBuddy Code automatically configures git to ignore this file Complete Configuration Example Available Settings supports the following options: Key Description Example : : : Preferred response language. When set, CodeBuddy Code will respond in the specified language. Leave empty to auto detect based on user input Custom script executed in that generates an authentication value. This value is sent as both and headers for model requests Model ID used for text to image generation Model ID used for image to image generation How long to locally retain chat history based on last activity date (default: 30 days) Environment variables applied to every session Whether to include attribution in git commits and pull requests (default: ) Permission configuration, see table below Configure custom commands to run before and after tool execution. See Disable all Override the default model used by CodeBuddy Code 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: → → → Configure a custom status line to display context. See Auto approve all MCP servers defined in the project's file List of specific MCP servers approved from files List of specific MCP servers rejected from files Enable auto compaction Auto update settings Always enable thinking mode Whether to show the tokens counter in the interface Custom"},{"id":"/cli/models","title":"models.json Configuration Guide","body":"models.json Configuration Guide Overview is a configuration file used to customize the model list and control the model dropdown display. This configuration supports two levels: User level: Global configuration applicable to all projects Project level: Project specific configuration with higher priority than user level Configuration File Locations User level Configuration Project level Configuration Configuration Priority Configuration merge priority from highest to lowest: 1. Project level models.json 2. User level models.json 3. Built in default configuration Project level configuration will override user level configuration for the same model definitions (based on field matching). field: project level completely overrides user level, no merging. Configuration Structure Configuration Field Description models Type: Define custom model list. You can add new models or override built in model configurations. LanguageModel Fields Field Type Required Description string ✓ Model unique identifier string Model display name string Model vendor (e.g., OpenAI, Google) string API key, supports environment variable references (see Security Configuration below) number Maximum input tokens number Maximum output tokens string API endpoint URL, supports environment variable references (must be complete interface path, typically ending with ) number Sampling temperature, range 0 2, higher values produce more random output, lower values produce more deterministic output boolean Whether tool calls are supported boolean Whether image input is supported boolean Whether reasoning mode is supported Important Notes: Currently only supports OpenAI interface format API field must be the complete interface path, typically ending with Examples: or Security Configuration: Using Environment Variable References To avoid storing API keys in plain text in configuration files, the and fields support environment variable reference syntax . Syntax Format: Configuration Example: Setting Environment Var"},{"id":"/cli/memory","title":"Managing CodeBuddy's Memory","body":"Managing CodeBuddy's Memory Learn how to manage CodeBuddy Code's memory across sessions using different memory locations and best practices. CodeBuddy Code can remember your preferences across sessions, such as code style guides and common commands in your workflow. Determining Memory Types CodeBuddy Code provides four hierarchically structured memory locations, each serving a different purpose: Memory Type Location Purpose Example Use Cases Shared With User Memory Personal preferences across all projects Code style preferences, personal tool shortcuts Only you (across all projects) User Rules Modular personal rules Personal coding habits, common workflows Only you (across all projects) Project Memory or Team shared instructions for a project Project architecture, coding standards, common workflows Team members via source control Project Rules Modular, topic specific project instructions Language specific guidelines, testing specifications, API standards Team members via source control Project Memory (Local) Personal project specific preferences Your sandbox URL, preferred test data Only you (current project) All memory files are automatically loaded into CodeBuddy Code's context at startup. The loading order is as follows: 1. User level: Load main files like and all rules under 2. Project level main files: Recursively load all and from current working directory upward 3. Project level rules: Only load rules under in the current working directory (not parent directories) 4. Subdirectory memory: When CodeBuddy operates on files in subdirectories, dynamically load that subdirectory's 5. Local memory: Load Tip: CODEBUDDY.local.md files are automatically added to .gitignore, making them ideal for storing private project specific preferences that should not be committed to version control. CODEBUDDY.md Imports CODEBUDDY.md files can import additional files using the syntax. The following example imports 3 files: Both relative and absolute paths are supported. In particul"},{"id":"/cli/statusline","title":"Status Line Configuration","body":"Status Line Configuration Create a custom status line for CodeBuddy Code to display contextual information Personalize CodeBuddy Code with a custom status line that displays at the bottom of the CodeBuddy Code interface, similar to how terminal prompts (PS1) work in shells like Oh my zsh. Creating a Custom Status Line You can choose one of the following methods: Run to have CodeBuddy Code help you set up a custom status line. By default, it will try to replicate your terminal's prompt, but you can provide additional instructions about desired behavior, like Add a command directly to your : How It Works The status line updates when conversation messages are updated Updates run at most every 300ms The first line of stdout from the command becomes the status line text ANSI color codes are supported for styling the status line CodeBuddy Code passes context information about the current session (model, directory, etc.) to your script via stdin in JSON format JSON Input Structure Your status line command receives structured data in JSON format via stdin: Example Scripts Simple Status Line Git Aware Status Line Status Line with Colors Showing Cost and Statistics Python Example Node.js Example Helper Function Approach For more complex bash scripts, you can create helper functions: Complete Example Advanced Examples Showing Current Time and Session Duration Color Coded by Cost Tips Keep the status line concise it should fit on one line Use emoji (if your terminal supports them) and colors to make information easy to scan Use for JSON parsing in Bash (see examples above) Test your script by running it manually with mock JSON input: Consider caching expensive operations (like git status) if needed Ensure script output is valid UTF 8 for correct display of Chinese characters and emoji Common ANSI Color Codes Troubleshooting Status Line Not Showing Check if the script is executable: Ensure the script outputs to stdout (not stderr) Verify JSON paths are correct: Chinese Character"},{"id":"/cli/env-vars","title":"Environment Variables Reference","body":"Environment Variables Reference CodeBuddy Code supports environment variables to control its behavior. These variables can be set before startup, or configured in the field of to apply to every session. Tip: All environment variables can also be set in the field of , which automatically applies them to every session or rolls out configuration for an entire team. Authentication Environment Variable Description API key. Set this key for model API calls. Always uses this key in non interactive mode ( ) CodeBuddy platform authentication token for all platform API calls Custom HTTP headers. Format: , multiple headers separated by newline or API Endpoints and Proxy Environment Variable Description Override the API endpoint address, typically used with Network environment configuration ( for China edition, for iOA enterprise edition) / HTTP proxy server address / HTTPS proxy server address / List of domains and IPs to bypass proxy (comma separated, e.g., ) Model Configuration Environment Variable Description Override the default agent model Small, fast model used for background tasks Large model used for complex reasoning tasks Model used by sub agents Enable extended thinking and set the token budget for the thinking process. Disabled by default Bash Tool Configuration Environment Variable Description Default timeout for long running bash commands (default: 120000) Maximum characters of bash output retained in memory (default: 30000, max: 150000). Content exceeding the limit is mid truncated (keeping head 20% + tail 80%), and the full output is automatically saved to disk Maximum timeout the model can set for long running bash commands (default: 600000) Tool Output Externalization Environment Variable Description Size threshold (KB) for tool result externalization. Non bash tool results exceeding this threshold are saved to disk and replaced with a placeholder (default: 50) Note: Bash tool output externalization is controlled by . When output is truncated due to exceeding"},{"id":"/cli/terminal-config","title":"Optimize Your Terminal Setup","body":"Optimize Your Terminal Setup CodeBuddy Code works best when your terminal is properly configured. Follow these guidelines to optimize your experience. 🎨 Themes and Appearance CodeBuddy Code cannot control the theme of your terminal. That's handled by your terminal application. You can match CodeBuddy Code's theme to your terminal any time via the command. For additional customization of the CodeBuddy Code interface itself, you can configure a to display contextual information like the current model, working directory, or git branch at the bottom of your terminal. ⌨️ Line Breaks You have several options for entering line breaks into CodeBuddy Code: Ctrl+J: Cross platform shortcut, press Ctrl+J to insert a newline when entering multi line input Quick escape: Type followed by Enter to create a newline Shift+Enter: Automatically configured via the command (recommended) Set up Shift+Enter (Recommended): Run within CodeBuddy Code to automatically configure Shift+Enter. Supported terminals: macOS: iTerm2, Terminal.app IDE: VSCode, Cursor, Windsurf, Zed, CodeBuddy JetBrains: PyCharm, IntelliJ IDEA, WebStorm, PhpStorm, GoLand, Rider, CLion, RubyMine, AppCode, DataGrip Terminal Emulators: Ghostty, WezTerm, Kitty, Alacritty, Hyper, Tabby, Warp Windows: Windows Terminal Set up Option+Enter (VS Code, iTerm2 or macOS Terminal.app): For Mac Terminal.app: 1. Open Settings → Profiles → Keyboard 2. Check \"Use Option as Meta Key\" For iTerm2 and VS Code terminal: 1. Open Settings → Profiles → Keys 2. Under General, set Left/Right Option key to \"Esc+\" 🔔 Notification Setup Never miss when CodeBuddy completes a task with proper notification configuration: iTerm 2 System Notifications For iTerm 2 alerts when tasks complete: 1. Open iTerm 2 Preferences 2. Navigate to Profiles → Terminal 3. Enable \"Silence bell\" and Filter Alerts → \"Send escape sequence generated alerts\" 4. Set your preferred notification delay Note that these notifications are specific to iTerm 2 and not available in the "},{"id":"/cli/ide-integrations","title":"IDE Integration","body":"IDE Integration CodeBuddy Code supports two integration methods with editors, both at the same level of IDE integration capabilities: 1. Using the ACP (Agent Client Protocol) as a universal \"Agent Server\" called by IDEs 2. Using the startup parameter and slash command as an \"IDE plugin backend companion process\" for deep integration Integration Method 1: ACP Protocol Integration Suitable for editors that support ACP, such as Zed, using CodeBuddy Code as a universal Agent Server. Supported Editors Zed Editor Full integration via ACP protocol, supporting: Project context awareness Tool operation delegation (file read/write, terminal commands) Permission request interaction Real time streaming responses For configuration details, see: Integration Method 2: IDE Plugin Integration ( / ) Suitable for VS Code / Cursor / Windsurf / JetBrains series IDEs, integrated through plugin + local MCP server. The IDE side plugin is responsible for: Creating and maintaining MCP connections (SSE / WebSocket) Passing workspace information, selections, and other context to CodeBuddy via MCP protocol Exposing IDE capabilities like / / / for CodeBuddy to call Startup Parameter When you start CodeBuddy directly in the terminal, you can use the parameter to have the CLI actively try to connect to the IDE corresponding to the current working directory: Behavior description: CodeBuddy will scan lock files created by IDE plugins in the current user directory to detect available IDE instances Only considers an IDE as \"valid\" if its workspace contains the current directory Prioritizes connecting to IDEs whose \"workspace matches and process chain is upstream of the current terminal\" After successful connection, the CLI will obtain from the IDE MCP server: File/diff preview (openFile / openDiff) Diagnostic information (getDiagnostics) Selection change notifications (selectionchanged) is just a quick connection method when \"you manually start the CLI from an IDE terminal\" and is not responsible for "},{"id":"/cli/acp","title":"ACP Protocol Integration","body":"ACP Protocol Integration ACP (Agent Client Protocol) is a universal agent protocol introduced by the Zed editor that decouples the core functionality (server) from the user interface (client) of agents, allowing users to freely combine different agent servers and clients. CodeBuddy Code natively supports the ACP protocol and can seamlessly integrate as an agent server with ACP compatible editors. Quick Start Starting ACP Mode Use the parameter to start the CodeBuddy Code ACP server: Zed Editor Integration Configuration Steps Open the Zed configuration file ( ) and add the following configuration: You can then create a CodeBuddy Code Thread in the Zed sidebar and start using it. Configuration Details command: Specify the CodeBuddy Code command path (ensure is available in PATH) args: Use to enable ACP protocol mode env: Optional environment variable configuration, for example: Note: When using , you must correctly configure based on your version: International version: Do not set (default) China version: iOA version: See for details. ACP Protocol Features Authentication Information Extension CodeBuddy Code returns user information in the field of the response: Clients can use this information to provide a better user experience, such as displaying the currently logged in user or personalizing the interface. Tool Proxy Mechanism The ACP protocol supports client side proxying of certain tool operations, improving performance and security: File Operation Proxy: Based on the client's and capabilities Terminal Operation Proxy: Based on the client's capability When a client declares support for these capabilities, CodeBuddy Code will automatically proxy related tool calls to the client for execution. Command List Push CodeBuddy Code automatically pushes the available slash command list ( ) to the client when creating a new session, enabling the client to: Provide command auto completion functionality Display command hints and help information Dynamically update available c"},{"id":"/cli/gitlab-ci-cd","title":"CodeBuddy Code GitLab CI/CD Integration","body":"CodeBuddy Code GitLab CI/CD Integration Overview CodeBuddy Code supports deep integration with GitLab CI/CD, enabling you to leverage AI assistance for code review, automated implementation, and intelligent optimization tasks within your CI/CD pipelines. This integration is built on top of the CodeBuddy Code CLI, allowing you to programmatically use AI capabilities in GitLab CI jobs. How It Works CodeBuddy Code leverages GitLab CI/CD to run AI tasks in isolated jobs and submit results via MRs: 1. Event Driven Orchestration: GitLab listens for your chosen triggers (e.g., Issues, MRs, or @codebuddy mentions in comments). Jobs collect context and codebase information, build prompts, and run CodeBuddy Code. 2. Sandboxed Execution: Each interaction runs in a container with strict network and filesystem rules. CodeBuddy Code enforces workspace scoped permission constraints on writes. Every change flows through MRs, reviewers can see diffs, and approval workflows still apply. Configuration Guide Quick Setup The fastest way to get started is to add a minimal job to .gitlab ci.yml and set your API key as a protected variable. Step 1: Add Protected CI/CD Variables Go to your GitLab project's Settings → CI/CD → Variables and add the following environment variables: Authentication Configuration: Add the following environment variables in your GitLab project's Settings → CI/CD → Variables: CODEBUDDYAPIKEY (Required) API key for model interface calls When configuring, check: ✅ Protect variable, ✅ Mask variable Optional Configuration: CODEBUDDYINTERNETENVIRONMENT Network environment configuration (China version users need to set to , iOA users set to ) CODEBUDDYBASEURL Custom base URL for model service (must be compatible with OpenAI API protocol) GITLABACCESSTOKEN GitLab project access token (requires api scope) Used for CodeBuddy to create/update MRs and comments If not configured, defaults to using When configuring, check: ✅ Protect variable, ✅ Mask variable 📖 Complete Configu"},{"id":"/cli/devcontainer","title":"CodeBuddy Code Dev Container","body":"CodeBuddy Code Dev Container CodeBuddy Code Dev Container provides a pre configured, secure development environment suitable for teams that need consistent and isolated workspaces. It seamlessly integrates with Visual Studio Code's Dev Containers extension and similar tools. Quick Start in Four Steps 1. Install VS Code and the Remote Containers extension 2. Create the directory and related files in your workspace following the configuration details below 3. Open the repository in VS Code 4. When prompted, click \"Reopen in Container\" (or use Command Palette: Cmd+Shift+P → \"Remote Containers: Reopen in Container\") 🚀 Installing CodeBuddy Code (Recommended Approach) Option 1: Using Dev Containers Feature (Recommended) Dev Containers Feature is the recommended way to install CodeBuddy Code in a Dev Container. It provides automatic version management, configuration consistency with other features, simplified maintenance, and more. Advantages: ✅ Automatic version management Easily upgrade to the latest version or pin to a specific version ✅ Configuration consistency Uses the same configuration approach as other Dev Containers features ✅ Simplified maintenance No need to manage complex installation logic in Dockerfile ✅ Team sharing Easy to standardize configuration across teams Configuration Method: Add configuration to the field in : Pin to Specific Version: Use Default Latest Version: Option 2: Manual Installation in Dockerfile If you need more control or have special scenarios, you can manually install in the Dockerfile. See the Dockerfile section below for details. 1. devcontainer.json Controls container settings, manages extensions, and configures volume mounts. Complete Example with Dev Containers Feature: Key Configuration Notes: Declares the use of CodeBuddy Code Dev Containers Feature, supports version management Uses the latest version (can be replaced with a specific version like \"2.16.0\") Note: When using the Feature approach, no parameter is needed in the Doc"},{"id":"/cli/mcp","title":"MCP (Model Context Protocol) Usage Documentation","body":"MCP (Model Context Protocol) Usage Documentation Overview MCP (Model Context Protocol) is an open standard that allows CodeBuddy to integrate with external tools and data sources. Through MCP, you can extend CodeBuddy's functionality by connecting to various external services, databases, APIs, and more. Core Concepts MCP Server An MCP server is an independent process that provides tools, resources, and prompts. CodeBuddy communicates with these servers through different transport protocols. MCP Prompts Integration MCP servers can provide Prompts (prompt templates), which are automatically converted into CodeBuddy's slash commands. When an MCP server is connected: Prompts provided by the server are automatically registered as slash commands Command name format: Supports dynamic parameters, collecting user input through an interactive interface Command execution calls the MCP server's interface to retrieve complete content Supports real time monitoring of configuration changes, automatically updating the list of available commands Transport Types STDIO: Communication with local processes via standard input/output SSE: Communication with remote services via Server Sent Events HTTP: Communication with remote services via HTTP streaming Configuration Scope user: Global user configuration, applied to all projects project: Project level configuration, applied to specific projects local: Local configuration, applied only to the current session or workspace For services with the same name (i.e., configurations with the same name across multiple scopes), the effective priority is: Security Approval Mechanism MCP servers in the project scope require user approval upon first connection to ensure security. The system displays detailed server information, and users can choose to approve or deny the connection. Approval in Non Interactive Mode ( p/ print) In non interactive mode (such as when using the parameter), since approval cannot be done through the UI, you need to pre confi"},{"id":"/cli/slash-commands","title":"CodeBuddy Code Slash Commands","body":"CodeBuddy Code Slash Commands CodeBuddy Code supports slash commands, allowing you to perform special operations, manage sessions, and customize common workflows within your chat. Built in Slash Commands These commands are used to manage your CodeBuddy Code sessions. Here is the current support status: Command Parameters CodeBuddy Support Description : : ✅ Supported Display help information and provide guidance on feedback channels. ✅ Supported Start a new conversation (old conversations can be restored via ). ✅ Supported Log in to your account. ✅ Supported Log out of your current account. ✅ Supported Check the status and environment of CodeBuddy Code. ✅ Supported Display the status of the current repository and session. ✅ Supported Add a working directory. Specify the path of the directory to add. ✅ Supported Manage experimental AI agents ✅ Supported Quick side question without interrupting the current Agent workflow. Useful for asking brief questions while the Agent is executing a task. Answers are generated based on existing context. ✅ Supported Compress context. ✅ Supported View or modify local configuration. Opens an interactive panel when used without parameters, lists current settings, reads a setting, modifies a setting. ✅ Supported Calculate the context token distribution for the current session. ✅ Supported Display session cost and token usage. ✅ Supported Initialize a new CodeBuddy repository. ✅ Supported Manage MCP connections. ✅ Supported Manage long term memory ✅ Supported Switch or view the currently used AI model. Opens an interactive selection interface when used without parameters, lists available models, or directly switches to the specified model when provided with a model name (e.g., ). ✅ Supported Switch or view the currently used text to image model. Opens an interactive selection interface when used without parameters, lists available models, or directly switches to the specified model when provided with a model ID. ✅ Supported Switch or view"},{"id":"/cli/keybindings","title":"Custom Keybindings","body":"Custom Keybindings Customize CodeBuddy Code keyboard shortcuts through the keybindings configuration file. CodeBuddy Code supports custom keyboard shortcuts. Run the command to create or open the configuration file located at . Contexts Each binding block specifies a context that determines when the shortcuts are active: Context Description : : Active anywhere in the application When the chat input box has focus When a text input box is active When the terminal view is active When the autocomplete menu is displayed When a confirmation/permission dialog is displayed When searching command history (Ctrl+R) When a task/agent is running in the foreground When the settings panel is open When the command palette is open When a select/list component has focus When a tool permission dialog is displayed When the help page is open When the plugin dialog is open When the diff dialog is open When the message selector (rewind) is open Key Syntax Modifiers Combine modifiers using the separator: or — Control key , , or — Alt/Option key — Shift key , , or — Meta/Command key Examples: Chords Chords are consecutive key combinations separated by spaces: Chords have a 1000ms timeout. If the second step is not completed before the timeout, the chord is cancelled. Special Keys or — Escape key or — Enter key — Tab key — Space key , , , — Arrow keys , — Delete keys Unbinding Default Shortcuts Set an action to to unbind a default shortcut: After unbinding all chord combinations, the prefix key can be used as a single key binding: 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 "},{"id":"/cli/sub-agents","title":"Sub-Agents","body":"Sub Agents Create and use specialized AI sub agents in CodeBuddy Code for specific task workflows and improved context management. Custom sub agents in CodeBuddy Code are specialized AI assistants that can be invoked to handle specific types of tasks. They enable more efficient problem solving by providing task specific configurations with custom system prompts, tools, and independent context windows. What are Sub Agents? Sub agents are pre configured AI personas that CodeBuddy Code can delegate tasks to. Each sub agent: Has a specific purpose and area of expertise Uses its own context window, separate from the main conversation Can be configured to allow specific tool usage Contains a custom system prompt that guides its behavior When CodeBuddy Code encounters a task that matches a sub agent's area of expertise, it can delegate that task to the specialized sub agent, which works independently and returns results. Key Benefits Benefit Description : : Context Preservation Each sub agent runs in its own context, preventing pollution of the main conversation and keeping it focused on high level goals. Specialized Expertise Sub agents can be fine tuned with domain specific detailed instructions, improving success rates for designated tasks. Reusability Once created, sub agents can be used across different projects and shared with your team for consistent workflows. Flexible Permissions Each sub agent can have different tool access levels, allowing you to restrict powerful tools to specific sub agent types. Quick Start To create your first sub agent: 1. Open Sub Agent Interface Run the following command: 2. Select \"Create New Agent\" Choose whether to create a project level or user level sub agent 3. Define Sub Agent Recommended: Start with AI generation, then customize to make it your own Describe your sub agent and when it should be used in detail Select the tools you want to grant access to, or leave empty to inherit all tools The interface shows all available tools If"},{"id":"/cli/agent-teams","title":"Agent Teams: Multi-Agent Collaboration","body":"Agent Teams: Multi Agent Collaboration Agent Teams lets you coordinate multiple CodeBuddy Code instances into a team, completing complex tasks through shared task lists, inter member messaging, and centralized management. This feature currently has . Agent Teams lets you coordinate multiple CodeBuddy Code instances working together. One session serves as the team lead, responsible for coordinating work, assigning tasks, and aggregating results; the remaining members (teammates) work independently, each with their own context window, and communicate directly with each other through a messaging system. Unlike , where sub agents run within a single session and can only report results back to the main agent, Agent Teams members can communicate directly with each other, and you can bypass the lead to talk to any member directly. When to Use Agent Teams Agent Teams is most effective for tasks where parallel exploration creates real value. Typical scenarios include: Research and Review: Multiple members investigate different aspects of a problem simultaneously, then share and challenge each other's findings New Module Development: Each member is responsible for an independent module without interfering with each other Competitive Hypothesis Debugging: Members test different hypotheses in parallel, converging on the correct answer faster Cross layer Coordination: Frontend, backend, and testing are each handled by different members, progressing in sync Agent Teams introduces additional coordination overhead, and token consumption is significantly higher than single session. It works best when members can work independently. For sequential tasks, same file edits, or work with complex dependencies, single session or sub agents are more appropriate. Comparison with Sub agents Sub agents Agent Teams : : : Context Independent context window, results returned to caller Independent context window, fully independent Communication Can only report results to the main agent Members can"},{"id":"/cli/skills","title":"CodeBuddy Code Skills (Skills System)","body":"CodeBuddy Code Skills (Skills System) Skills are CodeBuddy Code's extension capability system that allows you to create specialized domain knowledge and workflow templates, enabling the AI assistant to handle specific types of tasks with greater expertise. What are Skills Skills are like \"professional training\" for the AI assistant. With Skills, you can: Encapsulate specialized knowledge: Package domain specific best practices and operational procedures into reusable capabilities Provide workflow templates: Define standardized task processing flows to improve work efficiency Extend AI capabilities: Enable the AI assistant to handle more specialized and complex tasks Share team collaboration: Project level Skills allow teams to share specialized knowledge among members Skills vs Slash Commands Feature Skills Slash Commands Invocation Automatically identified and invoked by the AI model Manually entered by the user Use Case Specialized domain task processing Quick operations and workflows Permission Control Supports tool allowlist restrictions No special permission control Working Directory Supports custom base directory Uses current working directory Visibility Transparent to user, AI makes decisions automatically Actively initiated by user In simple terms: Slash Commands are shortcuts actively invoked by users Skills are specialized capabilities automatically selected by the AI based on task requirements Creating Skills Directory Structure Skills are defined by creating a file in specific directories: 1. Project level Skills: (in project root) 2. User level Skills: (in user home directory) Each Skill has its own directory containing a file: SKILL.md Format Skill files use Markdown format and support YAML Frontmatter for defining metadata: Frontmatter Fields Field Required Description Example No Skill name, uses directory name if not specified No Skill description, helps AI understand when to use it No Allowlist of permitted tools, comma separated No When set to , th"},{"id":"/cli/hooks-guide","title":"Hooks Guide","body":"Hooks Guide Learn how to customize and extend CodeBuddy Code's behavior by registering shell commands We recommend reading the first to understand all events, input/output structures, and security requirements. This guide focuses on practical walkthroughs and common examples to help you quickly enable Hooks functionality in your CodeBuddy Code projects. Note: The Hooks feature is currently in Beta and is being actively refined. Please watch for updates in future releases. Now you've mastered the core workflow for enabling hooks in CodeBuddy Code. For more details on event fields, decision control, and security considerations, check out the . Happy building powerful and secure automated workflows!"},{"id":"/cli/plugins","title":"CodeBuddy Plugin System","body":"CodeBuddy Plugin System CodeBuddy Code supports a powerful plugin system that allows you to extend and customize the CLI's functionality. Through plugins, you can add new commands, skills, and hooks, creating a personalized development environment that fits your workflow. Core Concepts What is a Plugin? A plugin is a reusable functionality package that can contain the following components: Commands: Slash commands that users can manually trigger Skills: Specialized capabilities that the AI automatically recognizes and invokes Hooks: Operations that automatically execute when specific events are triggered What is a Plugin Marketplace? A plugin marketplace is a publishing and distribution channel for plugins. CodeBuddy supports multiple types of plugin marketplaces: Local Directory Marketplace: Load plugins from the local filesystem GitHub Repository Marketplace: Fetch plugins from GitHub repositories HTTP/HTTPS Marketplace: Fetch plugin manifests and packages from HTTP(S) servers Quick Start There are three ways to manage plugins: Team Configuration Auto Installation, Interactive Interface, and Command Line Subcommands. Method 1: Team Configuration Auto Installation (Recommended) Teams can configure and in the project's to enable automatic plugin installation and activation. When team members start CodeBuddy, the system automatically installs the plugin marketplaces and plugins specified in the configuration. Configuration Example Add the following configuration to : Configuration Explanation : Define additional plugin marketplaces Key is the marketplace name (e.g., ) : Marketplace type, supports , , and : GitHub repository path (format: , only when source is ) : Git repository URL or HTTP(S) marketplace.json URL (only when source is or ) : Specify plugins to enable Key format: Value means enabled, means disabled Automatic Installation Flow 1. Startup Detection: CodeBuddy automatically detects the configuration file on startup 2. Marketplace Installation: Automatical"},{"id":"/cli/plugin-marketplaces","title":"Plugin Marketplaces","body":"Plugin Marketplaces A plugin marketplace is a plugin directory file used to distribute and manage CodeBuddy extensions. It is a JSON formatted configuration file that lists available plugins and their source information. Core Features Centralized Discovery: Browse plugins from multiple sources in one place Version Management: Automatically track and update plugin versions Auto Update: Support enabling auto update to periodically sync marketplace content Team Distribution: Share required plugins within organizations Flexible Sources: Support for Git repositories, GitHub repositories, local paths, and HTTP URLs Using Plugin Marketplaces Prerequisites CodeBuddy installed and running Basic understanding of JSON file format For creating a marketplace: Git repository or local development environment Adding a Plugin Marketplace 1. Add a GitHub Marketplace The repository must contain a file. 2. Add a Git Repository Marketplace 3. Add a Local Marketplace (for development) 4. Add an HTTP Marketplace Installing Plugins from a Marketplace Verifying Marketplace Installation 1. List Marketplaces: Run to confirm the marketplace was added 2. Browse Plugins: Use to view available plugins in the marketplace 3. Test Installation: Try installing a plugin to verify the marketplace is working properly Team Configuration Automatically Install Team Marketplaces Configure in : When team members start CodeBuddy, the system automatically installs these marketplaces and the plugins specified in the field. Automatic Installation Flow 1. Startup Detection: CodeBuddy automatically detects the configuration file on startup 2. Marketplace Installation: Automatically installs marketplaces from that are not yet installed 3. Plugin Installation: Automatically installs enabled plugins from that are not yet installed 4. Background Execution: The installation process executes asynchronously in the background without blocking the startup flow 5. Logging: The installation process logs detailed information,"},{"id":"/cli/checkpointing","title":"Checkpointing (Beta)","body":"Checkpointing (Beta) ⚠️ Beta Feature: Checkpointing is currently in Beta and features may change. Overview Automatically track and rewind CodeBuddy edits to quickly restore unwanted changes. CodeBuddy Code automatically tracks CodeBuddy's edits to files as you work, allowing you to quickly undo changes and revert to a previous state if something goes wrong. Common Use Cases Checkpointing is particularly useful in these scenarios: Exploring Alternatives: Try different implementation approaches without losing your starting point Recovering from Errors: Quickly undo changes that introduced bugs or broke functionality Feature Iteration: Confidently experiment knowing you can always restore to a working state See Also Keyboard shortcuts and session control Use to access checkpoints"},{"id":"/cli/worktree","title":"Git Worktree Support","body":"Git Worktree Support Run CodeBuddy in isolated workspaces for parallel development and safe isolation. Overview Git worktree allows you to have multiple working directories simultaneously within the same repository, each checked out to a different branch. CodeBuddy Code leverages this feature to provide: Parallel development: Perform experimental development without affecting the main workspace Safe isolation: All AI changes are made in a separate directory Zero storage overhead: Worktrees share Git objects without duplicating the entire repository Sub agent isolation: Multiple AI sub agents can work in parallel in independent worktrees tmux integration: Optionally run in a dedicated tmux session Non Git support: SVN, Perforce, and other projects can also use worktree isolation via WorktreeCreate/WorktreeRemove hooks Quick Start Creating Within a Session After starting a CodeBuddy Code session, you can create a worktree via natural language: The AI will automatically invoke the tool to create an isolated working directory and switch to it. Note: This is only triggered when \"worktree\" is explicitly mentioned. Saying \"create a branch for me\" or \"fix this bug\" will not automatically create a worktree. CLI Parameters Parameter Description Example : : : Create and enter a worktree or Specify the base branch (requires ) or Run in a tmux session (requires tmux installed) Use classic tmux mode (without popup) Workflow Creating a Worktree When starting with the parameter: 1. CodeBuddy creates a new worktree under the directory 2. Determines the base branch: If is specified, uses the remote branch If is specified, uses the local branch If not specified, defaults to the remote default branch (usually or ) 3. Automatically creates a corresponding branch (e.g., ) 4. Switches the working directory to the worktree 5. Runs initialization (copies settings, creates symlinks, copies files, etc.) Behavior when the branch does not exist: If the specified branch (remote or local) does no"},{"id":"/cli/remote-control","title":"Remote Control","body":"Remote Control Beta: The Remote Control feature is currently in Beta. Functionality and interfaces may change in future releases. Feel free to try it out and share your feedback. With Remote Control, you can access a locally running CodeBuddy Code session from your phone, tablet, or any browser. The session always runs on your local machine — the Web UI is simply a remote window. Overview Remote Control starts a Gateway service locally and exposes a Web UI through a Cloudflare Tunnel or LAN, allowing you to connect to a running CodeBuddy Code session from any device. With Remote Control, you can: Use your full local environment remotely: File system, MCP servers, and tool configurations all remain available Interact with the Agent via Web UI: Send messages, view conversations, and monitor tool execution in the browser Connect from multiple devices: Scan a QR code from your phone to connect, with both LAN and public network access supported Manage sessions from the terminal: Work simultaneously in the terminal and the Web UI, with conversations kept in sync Prerequisites CodeBuddy Code installed and logged in (run and use to log in) For public network access, install (optional) Starting Remote Control Use the command in a CodeBuddy Code session to start the Remote Control service: Once started successfully, the terminal displays connection information: Connection Methods After the Gateway starts, you can connect from other devices in the following ways: Scan the QR code: Scan the QR code displayed in the terminal with your phone to open the Web UI directly Copy the Web UI link: Open the URL with the authentication token in any browser LAN access: Devices on the same network can access the Local address directly (e.g., ) Subcommands Command Description : : Start the Gateway (with Tunnel by default) View the current Gateway status Stop the Gateway Regenerate the authentication token Start the Gateway with Tunnel Network Modes The Gateway supports two network modes to a"},{"id":"/cli/web-ui","title":"Web UI","body":"Web UI CodeBuddy Code provides a built in Web UI that offers a full featured browser interface for interacting with the Agent. When you start CodeBuddy Code in serve mode or enable Remote Control, the Web UI is automatically available. Overview The Web UI provides the same core capabilities as the terminal interface, with a visual layout optimized for browsers: Chat: Send messages, view conversations, and monitor tool execution in real time Terminal: Embedded terminal with split pane support (up to 4 panels) Workers: Manage CLI Worker processes and the Daemon process Logs: Dedicated log viewer with support for multiple log types and keyword search Remote Control: Connect WeChat and WeCom channels Monitoring: System resource metrics and per Worker process level memory/uptime metrics Tasks: Browse task templates and create scheduled tasks Plugins: Manage plugin installations and plugin marketplace Settings: Configure theme, language, model, and permission mode Documentation: Browse CLI documentation with full text search API Reference: View the interactive Swagger UI for HTTP API exploration Accessing the Web UI Method 1: Serve Mode Start CodeBuddy Code with the flag: Then open in your browser: Method 2: Remote Control In an existing CodeBuddy Code session, start the Gateway: The terminal displays a QR code and URL. Scan the QR code with your phone or open the URL in any browser. See the documentation for details. Authentication The Web UI supports two authentication modes: Mode Setting Description : : : No Auth (default) No password required Password Password shown in terminal on startup Authentication methods (any one is sufficient): URL parameter: — auto login via URL Login page: Enter the password displayed in the terminal Bearer token: for API access Configure in : Features Chat View The default view for conversing with the Agent. Key features: Rich message rendering: Markdown, syntax highlighted code blocks, tables, and images Tool execution display: See tool ca"},{"id":"/cli/scheduled-tasks","title":"Scheduled Tasks","body":"Scheduled Tasks CodeBuddy Code supports creating and managing scheduled tasks within a session. You can set up tasks that execute instructions on a recurring schedule or trigger a one time action at a specific future time. Common use cases include: periodically checking build status, polling for task completion, setting reminders at specific times, and more. Note: Scheduled tasks are session scoped. Tasks are only active while CodeBuddy Code is running and are automatically cleared upon exit. Creating One Time Reminders If you only need a reminder at a specific future time, you can describe it in natural language: These tasks trigger once at the specified time and are automatically deleted after execution. Task Execution Mechanism Execution Timing Tasks only trigger when the session is idle — that is, when the system is not processing other requests. If an operation is in progress when the task is due, the trigger is deferred until the operation completes. Time Jitter The system adds a small random offset to task trigger times to prevent congestion from many tasks firing simultaneously: Recurring tasks: Delayed by up to 10% of the cycle duration (capped at 15 minutes) One time tasks: For tasks set to the hour or half hour, may trigger up to 90 seconds early For example, a task set to run may actually trigger randomly within 0–6 minutes after the hour. Auto Expiration Recurring tasks automatically expire and are deleted after 3 days, with one final trigger before expiration. If you need tasks to persist longer, you can recreate them after expiration or use an external scheduling solution (such as GitHub Actions). Cron Expression Reference For precise schedules like \"every Monday at 10 AM\" or \"the 1st of every month,\" simply describe your requirement to the AI, and it will automatically convert it to a cron expression and create the task: The AI response will include the actual cron expression and execution frequency used, so you can confirm whether it matches your ex"},{"id":"/cli/wecom-bot-setup","title":"WeChat Work AI Bot Integration Guide","body":"WeChat Work AI Bot Integration Guide Through the command, you can quickly integrate CodeBuddy Code with WeChat Work AI Bot, enabling remote message driven functionality. Using WebSocket long polling active connection mode, no public IP is required, making configuration the simplest option. Prerequisites Registered WeChat Work account CodeBuddy Code installed: Completed login authentication: After running , execute 2. Configure Environment Variables Before starting CodeBuddy CLI, set the following environment variables: Optional Configuration Environment Variable Description Default Value AI Bot ID (required) — AI Bot Secret (required) — WebSocket server address (used for private deployment) Persistent Configuration (Optional) Add environment variables to your shell startup file for automatic loading on each startup: 4. Panel Operation Instructions Operation Description / Select client entry / Vim style navigation (equivalent to up/down arrow keys) Connect (in state) or disconnect (in / state) Exit panel (not responsive during operations in progress) 5. Verify Integration After establishing the connection, you can verify that the Bot is working properly through the following methods. Method 1: Direct Conversation 1. Open the WeChat Work client (desktop or mobile) 2. Find the Bot you created in the message list 3. Send a test message (such as \"Hello\") and confirm the Bot replies Method 2: Group Chat 1. Add the Bot to a group chat 2. Send a message via @Bot name in the group 3. The Bot will respond to @mentioned messages 6. Message Processing Flow and Status Indicators Complete Message Processing Flow The processing flow after a user sends a message to the Bot: Streaming Status Indicator Mechanism Utilizing the full replacement feature of WeChat Work streaming messages ( stream type): 1. Immediate Reply: After receiving a user message, immediately send a streaming message with , content: \"Processing, please wait...\" 2. In place Replacement: After the Agent finishes pro"},{"id":"/cli/channels","title":"Channels: Push External Events into Sessions [Beta]","body":"Channels: Push External Events into Sessions [Beta] Beta Feature: Channels is currently in Beta. Features and interfaces may be adjusted based on feedback. A Channel is an MCP server that pushes messages, alerts, and webhooks into your running CodeBuddy Code session, allowing CodeBuddy Code to react to external events even when you're not at the terminal. Channels can be two way: CodeBuddy Code reads events and replies through the same channel, acting like a chat bridge. Events only arrive while a session is open; for continuous operation, run CodeBuddy Code in a background process or persistent terminal. You can enable channels by installing plugins or using built in channels. WeChat, Telegram, Discord, and the fakechat demo are all supported. When CodeBuddy Code replies through a channel, the terminal shows the tool call and confirmation (e.g., \"sent\"), while the actual reply content appears on the corresponding chat platform. This page covers: : WeChat, Telegram, Discord, and fakechat setup : Quick hands on experience with the WeChat channel : Sender allowlists and pairing flows : Enabling channels for teams and enterprises To build your own channel, see the . Supported Channels WeChat (Built in) The WeChat channel is built into CodeBuddy Code and requires no plugin installation. It enables two way messaging through WeChat ClawBot, supporting text, images, and file exchange. Prerequisites: WeChat version iOS 8.0.70 or above Enable the ClawBot plugin in WeChat (WeChat Me Settings Plugins ClawBot) QR Code Binding: 1. In CodeBuddy Code, run or and select wechat 2. The terminal displays a QR code (if the QR code doesn't render correctly, a browser link will be provided) 3. Scan the QR code with WeChat and confirm 4. After successful binding, message reception starts automatically Usage: After binding, send messages in the WeChat ClawBot conversation, and they will automatically appear in the CodeBuddy Code session: CodeBuddy Code processes the message and replies via"},{"id":"/cli/daemon","title":"Daemon Mode and Background Sessions","body":"Daemon Mode and Background Sessions Daemon mode runs CodeBuddy Code as a background resident service, independent of any terminal window. Once started, it provides a full HTTP API and Web UI, ready to accept requests at any time. Core value: Transform the CLI from \"use and go\" to \"always on standby\". Concepts Concept Description Worker A running CLI process, registered via a PID file in Daemon A background resident HTTP service process ( mode), managed via Background Session (bg) A non interactive task started with , with output automatically logged to a file Daemon Management Starting the Daemon Once started, the daemon runs as a detached process and the parent process exits immediately. Local addresses have password free access by default; non local addresses automatically enable password authentication. Idempotent startup: Running multiple times does not create multiple daemons. If a daemon is already running, it returns the existing daemon's information. Checking Status Stopping / Restarting Background Sessions Starting Background Tasks Background sessions run in mode (no TUI + skip permission confirmations), with stdout/stderr redirected to . Process Management Commands HTTP API All Worker and Daemon management capabilities are exposed via REST APIs. The Web UI Workers page is built on top of these APIs. See the Workers & Daemon section in the for details. Examples Web UI After starting in mode, the Web UI provides three management pages: Workers — Worker process management and Daemon control Logs — Standalone log viewer with Worker selection, log type switching, and keyword search Metrics — System resource monitoring and per Worker process level metrics Log System The log API supports 4 types, with automatic priority based selection: Type Path Content Trigger Info/Warn/Error from all modules Always (default priority) Process stdout/stderr bg/daemon only Detailed debug information Requires Conversation history Always PID File Registry Each CLI process registers"},{"id":"/cli/security","title":"Security","body":"Security Learn about CodeBuddy Code's security protections and best practices for secure usage. Security Approach Security Foundation Your code security is paramount. CodeBuddy Code is built with security as a core principle, developed following Tencent's comprehensive security program. Permission Based Architecture CodeBuddy Code uses strict read only permissions by default. When additional operations are needed (editing files, running tests, executing commands), CodeBuddy Code requests explicit permission. Users control whether to approve operations once or allow automatically. We designed CodeBuddy Code to be transparent and secure. For example, we require approval before executing bash commands, giving you direct control. This approach enables users and organizations to configure permissions directly. For detailed permission configuration, see . Built in Protections To mitigate risks in agentic systems: Sandboxed bash tool: isolates bash commands' file system and network access, reducing permission prompts while maintaining security. Enable with to define boundaries within which CodeBuddy Code can work autonomously Write Access Restrictions: CodeBuddy Code can only write to the folder where it was launched and its subfolders—cannot modify files in parent directories without explicit permission. While CodeBuddy Code can read files outside the working directory (useful for accessing system libraries and dependencies), write operations are strictly limited to project scope, creating a clear security boundary Prompt Fatigue Mitigation: Support for whitelisting frequently used safe commands per user, per codebase, or per organization Accept Edits Mode: Batch accept multiple edits while maintaining permission prompts for commands with side effects User Responsibility CodeBuddy Code only has the permissions you grant it. You are responsible for reviewing the security of suggested code and commands before approval. Prompt Injection Protection Prompt injection is an atta"},{"id":"/cli/iam","title":"Identity and Access Management","body":"Identity and Access Management Learn how to configure user authentication, authorization, and access control for CodeBuddy Code in your organization. Authentication Methods Quick Start Choose an authentication method based on your scenario: Scenario Recommended Method How to Get Credentials : : : Individual Developer Enterprise/Team (OAuth Integration) CI/CD with existing OAuth token Use existing token directly Third party Model Service + Get from third party provider When multiple authentication methods are configured, they take effect in the following priority: CODEBUDDYAUTHTOKEN apiKeyHelper CODEBUDDYAPIKEY Enterprise Users: OAuth Authentication Suitable for enterprise/team integration, obtaining tokens via OAuth 2.0. Currently only introducing the Client Credentials authorization method, suitable for server side applications and CI/CD scenarios. Prerequisite: Enterprise users need to purchase CodeBuddy Premium before using OAuth authentication. See the for details. Step 1: Create Application, Get Client ID and Secret Refer to the to complete: 1. Create an enterprise application 2. Get Client ID and Client Secret Step 2: Create a Script to Get Token Step 3: Configure apiKeyHelper Configure in or project : After configuration, you can use the command. Tokens obtained by apiKeyHelper are cached for 5 minutes by default. You can adjust this via the environment variable (in milliseconds). Authentication Methods Explained CODEBUDDYAPIKEY Static API Key, suitable for most scenarios. Feature Description : : Environment Variable Auth Type API Key (X Api Key header) Use Cases Personal development, third party model services Warning: When using API Key, you must also configure the environment variable! Version Configuration Value : : International Not set (default) China iOA CODEBUDDYAUTHTOKEN Pre obtained OAuth Bearer Token, suitable for CI/CD or scenarios with existing tokens. Feature Description : : Environment Variable Auth Type Bearer Token (Authorization header) Use "},{"id":"/cli/bash-sandboxing","title":"Bash Sandbox","body":"Bash Sandbox Learn how CodeBuddy Code's sandboxed Bash tool provides file system and network isolation for safer, more autonomous agent execution. Overview CodeBuddy Code features native sandbox capabilities that provide a more secure environment for agent execution while reducing constant permission prompts. Instead of requiring permission for every bash command, the sandbox creates predefined boundaries that allow CodeBuddy Code to work more freely with reduced risk. The sandboxed Bash tool uses operating system level primitives to enforce file system and network isolation. Why Sandbox Matters Traditional permission based security requires continuous user approval for bash command execution. While this provides control, it can lead to: Approval Fatigue: Repeatedly clicking \"approve\" may cause users to pay less attention to what they're approving Reduced Productivity: Constant interruptions slow down development workflows Limited Autonomy: CodeBuddy Code cannot work efficiently while waiting for approvals Sandbox addresses these challenges by: 1. Defining Clear Boundaries: Explicitly specifying which directories and network hosts CodeBuddy Code can access 2. Reducing Permission Prompts: Safe commands within the sandbox don't require approval 3. Maintaining Security: Attempts to access resources outside the sandbox trigger immediate notifications 4. Enabling Autonomy: CodeBuddy Code can run more independently within defined limits <Warning Effective sandboxing requires both file system and network isolation. Without network isolation, a compromised agent could exfiltrate sensitive files (like SSH keys). Without file system isolation, a compromised agent could backdoor system resources to gain network access. When configuring sandbox, it's important to ensure your configuration settings don't create bypasses in these systems. </Warning How It Works File System Isolation The sandboxed Bash tool restricts file system access to specific directories: Default Write Behavi"},{"id":"/cli/cli-reference","title":"CLI Reference","body":"CLI Reference Complete reference manual for the CodeBuddy Code command line tool, including all commands and parameter descriptions. CLI Commands Command Description Example : : : Start interactive REPL Start REPL with initial prompt Query via SDK and exit Process piped content Continue the most recent conversation Continue conversation via SDK Resume session by ID Update to the latest version Configure Model Context Protocol (MCP) servers See Start the Daemon process Stop the Daemon View Daemon status Restart the Daemon List all active Worker processes View Worker logs Attach to a background Worker Terminate a Worker process CLI Parameters Command line parameters to customize CodeBuddy Code behavior: Parameter Description Example : : : Add additional working directories for CodeBuddy to access (validates each path for existence) Dynamically define custom via JSON (format described below) List of tools allowed without prompting the user, in addition to List of tools to disallow, in addition to Restrict available built in tool set (whitelist). Empty string disables all built in tools, uses all tools, or specify comma separated tool names , Print response and exit without entering interactive mode Load additional settings configuration from a JSON file or JSON string Specify which settings sources to load, comma separated (options: , , ). Default: Replace the entire system prompt with custom text (available in both interactive and print modes) Load system prompt from file, replacing the default (print mode only) Append custom text to the end of the default system prompt (available in both interactive and print modes) Specify output format for print mode (options: , , ) Specify input format for print mode (options: , ) Validate structured output with JSON Schema. Example: Include partial streaming events in output (requires and ) Enable verbose logging, showing complete turn output (helpful for debugging in both print and interactive modes) Limit the number of agent tu"},{"id":"/cli/hooks","title":"Hooks Reference","body":"Hooks Reference Version requirement: This guide targets the Claude Code Hooks–compatible implementation shipped with CodeBuddy Code v1.16.0 and later. Feature status: Hooks are currently in Beta; APIs and runtime behavior may evolve. Hooks let you inject custom scripts or commands into every stage of a CodeBuddy Code session so you can automate validation, bootstrap environments, run compliance checks, and more. Our implementation is fully compatible with the Claude Code Hooks specification, including event names, payload schemas, and safety guarantees. Configuration CodeBuddy Code stores hook configuration inside your settings files: Scope Path Notes User Applies to every project Project Shared with the whole repo Project local Local only overrides (not committed) Enterprise policy Distributed policy bundle Managed centrally by your org Merge behavior: Hooks from different scopes are merged, not overwritten. All matching hooks for the same event run in parallel. Structure Hooks are grouped by matcher, and each matcher may contain multiple hook definitions: Key fields: matcher – Regex pattern for tool names, case sensitive (only for and ). Simple string match: matches any tool name containing \"Write\" (e.g., , ). Exact match: Use to match only the Write tool. Multiple tools: or . Match all tools: Any of the following are equivalent: Use Use empty string Omit the field hooks – Array executed when the matcher hits. type – Execution mode. Use for shell commands, or for LLM based evaluation. command – (type = ) Shell command to run. is available. Executed using the user's default shell ( ) on macOS/Linux, and Git Bash is enforced on Windows (cmd.exe and PowerShell are not supported), so commands must be compatible with bash syntax. prompt – (type = ) Prompt text sent to the LLM for evaluation (only supports , , and events). timeout – Optional timeout in seconds for the specific hook. For events that do not use matchers ( , , , etc.) you can omit the field entirely: Proje"},{"id":"/cli/plugins-reference","title":"CodeBuddy Plugin Reference","body":"CodeBuddy Plugin Reference Overview The CodeBuddy plugin system allows you to extend the AI assistant's functionality through a standardized plugin mechanism. Plugins can provide custom commands, agents, skills, hooks, MCP servers, and LSP servers. description: Command description allowed tools: Read,Write,Bash argument hint: Argument hint model: Model ID or name to use name: Agent name (optional, defaults to filename) description: Agent description model: Model ID or name to use tools: Read,Write,Bash (comma separated list of available tools) color: #FF5733 (agent display color, optional) Agent instruction content skills/ ├── pdf processor/ │ ├── SKILL.md │ ├── reference.md (optional) │ └── scripts/ (optional) └── code reviewer/ └── SKILL.md markdown name: Skill name (optional, defaults to directory name) description: Skill description allowed tools: Read,Write,Bash (list of allowed tools) Skill instruction content json { \"PostToolUse\": [ { \"matcher\": \"Write Edit\", \"hooks\": [ { \"type\": \"command\", \"command\": \"${CODEBUDDYPLUGINROOT}/scripts/format code.sh\", \"timeout\": 30000 } ] } ] } json { \"mcpServers\": { \"plugin database\": { \"command\": \"${CODEBUDDYPLUGINROOT}/servers/db server\", \"args\": [\" config\", \"${CODEBUDDYPLUGINROOT}/config.json\"], \"env\": { \"DBPATH\": \"${CODEBUDDYPLUGINROOT}/data\" } }, \"plugin api client\": { \"command\": \"npx\", \"args\": [\"@company/mcp server\", \" plugin mode\"], \"cwd\": \"${CODEBUDDYPLUGINROOT}\" } } } json { \"go\": { \"command\": \"gopls\", \"args\": [\"serve\"], \"extensionToLanguage\": { \".go\": \"go\" } } } json { \"name\": \"my plugin\", \"lspServers\": { \"go\": { \"command\": \"gopls\", \"args\": [\"serve\"], \"extensionToLanguage\": { \".go\": \"go\" } } } } json { \"name\": \"plugin name\", \"version\": \"1.2.0\", \"description\": \"Brief plugin description\", \"author\": { \"name\": \"Author Name\", \"email\": \"[email protected]\", \"url\": \"https://github.com/author\" }, \"homepage\": \"https://docs.example.com/plugin\", \"repository\": \"https://github.com/author/plugin\", \"license\": \"MIT\", \"keywords\": [\"ke"},{"id":"/cli/costs","title":"Cost Management","body":"Cost Management Optimize costs through multi scenario model selection and asynchronous compression strategies, achieving faster response times and lower usage costs while maintaining effectiveness. CodeBuddy Code consumes tokens with each interaction. Costs vary based on codebase size, query complexity, and conversation length. This document covers how to track costs, multi scenario model mechanisms, and how to reduce token consumption. Tracking Costs Using /cost Command The command provides detailed token usage statistics for the current session: Using /context Command The command analyzes current context usage, showing size distribution across different context types: Use to quickly identify what's consuming significant context space and optimize accordingly. Multi Scenario Model Mechanism Different task scenarios have different model capability requirements. Simple file searches and quick queries can be completed with lightweight models; complex architectural design and multi step reasoning require more powerful reasoning models. By automatically selecting different models for different scenarios, you can achieve: Optimal effectiveness: Complex tasks use high capability models to ensure quality Faster speed: Simple tasks use lightweight models for quicker responses Lower costs: Avoid using expensive high end models for simple tasks Scenario Types Scenario Type Description Typical Use Cases : : : Default model, balanced performance and cost General programming tasks, code writing Lightweight fast model, low cost and high speed File search, simple queries, quick operations Reasoning enhanced model, powerful analysis capability Complex analysis, architectural decisions, multi step reasoning Automatic Model Selection CodeBuddy Code automatically selects appropriate scenario models based on task type. When sub agents execute, the system automatically resolves the corresponding scenario model based on the user's currently selected main model. For example, lightweight s"},{"id":"/cli/tools-reference","title":"Tools Reference","body":"Tools Reference Complete reference for CodeBuddy Code's available tools, including permission requirements. CodeBuddy Code includes a set of built in tools to help understand and modify your codebase. The tool names in the table below are the identifiers used in , , and . Tool Description Requires Permission : : : Spawns a with an independent context window to handle tasks No Asks the user a multiple choice question to gather requirements or clarify ambiguities Yes Executes shell commands in your environment. See Yes Schedules recurring or one time tasks within the current session (expires on exit). See No Cancels a scheduled task by ID No Lists all scheduled tasks in the current session No Executes a deferred tool discovered via No Performs precise string replacement edits on files Yes Switches to plan mode for designing implementation approaches before coding No Creates an isolated and switches into it Yes Submits a plan for user approval and exits plan mode Yes Finds files using glob patterns No Searches file contents using regex patterns No Edits or modifies existing images based on text instructions Yes Generates images from text descriptions Yes Exits the worktree session and returns to the original directory Yes 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 and its language server binary No Performs multiple edits on the same file in a single atomic operation Yes Modifies Jupyter notebook cell contents Yes Executes PowerShell commands on Windows. Only available on Windows, see Yes Reads file contents, supporting images, PDFs, and Jupyter notebooks No Sends messages to teammates in an No Executes a in the main conversation No Executes a custom Yes Returns structured output conforming to a JSON Schema No Creates a new task in the"},{"id":"/cli/channels-reference","title":"Channels Reference [Beta]","body":"Channels Reference [Beta] Beta Feature: Channels is currently in Beta. The protocol and interfaces may be adjusted based on feedback. A Channel is a special MCP server that pushes external events (webhooks, chat messages, monitoring alerts, etc.) into a CodeBuddy Code session, allowing CodeBuddy Code to react to things happening outside the terminal. Overview A Channel runs on the same machine as CodeBuddy Code and communicates via stdio. CodeBuddy Code launches it as a child process. Typical use cases: Chat platforms (Telegram, Discord): The plugin runs locally, polls the platform API for new messages, and forwards them to CodeBuddy Code Webhooks (CI, monitoring): A server listens on a local HTTP port, receives POST requests from external systems, and pushes them to CodeBuddy Code Channels operate in two modes: Mode Description One way Only forwards events to CodeBuddy Code (alerts, webhooks), processed in the local session Two way Additionally exposes a reply tool, allowing CodeBuddy Code to send responses Using a Channel Startup Use the parameter to specify which channels to load: Development Mode Use the flag to test custom channels during initial development. This flag allows any channel to run without being on the allowlist: This flag only bypasses the allowlist check; the organization policy still applies. Once a channel is submitted to the official marketplace and passes security review, it gets added to the allowlist and can be loaded directly with . Channel Messages in Sessions Channel messages are injected into CodeBuddy Code's context as tags: In the TUI, channel messages are displayed in a friendly format: Settings Channel functionality can be controlled in : Set to to completely disable channel functionality. Building a Channel Basic Requirements A channel server needs to: 1. Declare the capability so CodeBuddy Code registers a notification listener 2. Send events 3. Connect via stdio transport (CodeBuddy Code launches it as a child process) Minimal Ex"},{"id":"/cli/http-api","title":"CodeBuddy Code HTTP API <sup>Beta</sup>","body":"CodeBuddy Code HTTP API <sup Beta</sup Beta: This API is in Beta. Interfaces may be adjusted. Feedback is welcome. CodeBuddy Code provides two public interface sets for developers building Agent applications: REST API ( ) — Stateless HTTP request/response, suitable for webhook integration, management operations, and simple queries ACP ( ) — Stateful streaming protocol (JSON RPC over SSE), suitable for building full Agent client applications Quick Start Starting the HTTP Service API Documentation (Swagger UI) Once the service is running, visit: Interactive docs: OpenAPI spec: Swagger UI provides an interactive testing interface for all public endpoints. Verify the Service API Layers Layer Route Prefix Compatibility Promise Description Public REST API Semantic versioning, no breaking changes Covered in this document Public ACP Protocol Follows ACP specification Full conversation capabilities, see Internal RPC No compatibility guarantee For internal CLI use, not publicly available Authentication Two modes are supported (controlled by environment variable ): Mode Value Description No authentication (default) For local development, no authentication required Password authentication Automatically enabled for remote access Password authentication supports the following methods (any one passing is sufficient): Response Format All endpoints use a unified envelope format: Endpoint Overview System Method Endpoint Description GET Health check GET Environment info (version, OS, CWD, etc.) GET System resource metrics + instance process metrics GET Environment variables (aligned with E2B envd) Authentication Method Endpoint Description GET Get authentication status POST Password login, returns token Runs (Agent Execution) Method Endpoint Description POST Initiate Agent execution (async, returns runId) GET Query execution status GET SSE streaming of execution results POST Cancel execution Webhooks (Third party Platform Integration) Method Endpoint Description GET Platform URL verif"},{"id":"/cli/sdk","title":"CodeBuddy Agent SDK","body":"CodeBuddy Agent SDK Version Requirements: This documentation is for CodeBuddy Agent SDK v0.1.0 and above. Feature Status: The SDK is currently in Preview stage, and interfaces and behaviors may be adjusted in future versions. ::: warning Important: Environment Isolation The SDK does not load any filesystem configurations by default, including , , MCP servers, sub agents, slash commands, Rules, and Skills. This is a key difference from direct CLI usage, ensuring SDK application behavior is completely controlled by code with predictability and consistency. To load these configurations, use the option to explicitly specify. See section for details. ::: CodeBuddy Agent SDK allows you to programmatically control CodeBuddy Agent in your applications. It supports TypeScript/JavaScript and Python, enabling scenarios such as automated task execution, custom permission control, and building AI powered development tools. Why Use the SDK CodeBuddy Agent SDK gives you programmatic access to all of CodeBuddy's capabilities, not just through command line interaction. Beyond Command Line Programmatic Control: Embed AI programming assistants in your applications to implement automated workflows Custom Interactions: Build user interfaces and interaction methods that suit your needs Batch Processing: Perform batch AI operations on multiple files or projects Integrate with Existing Systems: Seamlessly integrate AI capabilities into CI/CD, IDE plugins, or other development tools Fine grained Control Permission Management: Implement enterprise level permission policies through callbacks Behavior Customization: Use the Hook system to intercept and modify Agent behavior Resource Limits: Control token consumption, execution time, and budget Session Management: Persist and restore conversation contexts Extended Capabilities Custom Agents: Create specialized sub agents to handle domain specific tasks MCP Integration: Connect custom tools and services Multi model Support: Flexibly switch and c"},{"id":"/cli/sdk-python","title":"Python SDK Reference","body":"Python SDK Reference Version Requirement: This document is for CodeBuddy Agent SDK v0.1.0 and above. This document provides a complete API reference for the Python SDK. For quick start and usage examples, please refer to . Requirements Dependency Version Requirement Python = 3.10 CodeBuddy CLI Installed Async Runtime: The SDK is based on , all APIs are asynchronous. Installation Recommended to use for dependency management: Or using pip: Environment Variables Variable Name Description Required CodeBuddy CLI executable path Optional If not set, the SDK will look for CLI in the following order: 1. Environment variable 2. Built in binary within SDK package 3. Development environment monorepo path Authentication Configuration The SDK supports authentication using existing login credentials, API Key, or OAuth Client Credentials. See for details. Functions query() Main API entry point, creates a query and returns an async iterator of messages. Parameters: Parameter Type Description Query prompt or user message stream Configuration options (optional) Custom transport layer (optional) Returns: Async iterator of messages Example: Client Class CodeBuddySDKClient Client class for bidirectional interactive conversations. Supports multi turn dialogues, interruptions, and dynamic control. Methods: connect() Connect to CodeBuddy. query() Send user message. receiveresponse() Receive messages until a ResultMessage is received. receivemessages() Receive all messages (does not auto stop). disconnect() Disconnect. Context Manager Support: mcpserverstatus() Get MCP server connection status. Authentication The SDK provides an independent authentication API with a two phase design: first obtain the login URL, then wait for the user to complete authentication. authenticate() Start the authentication flow, returns an object. Parameters: Parameter Type Description Authentication method identifier (default ) Predefined environment name Custom endpoint URL (mutually exclusive with environment)"},{"id":"/cli/sdk-typescript","title":"TypeScript SDK Reference","body":"TypeScript SDK Reference Version Requirements: This documentation is for CodeBuddy Agent SDK v0.1.0 and above. This document provides a complete API reference for the TypeScript SDK. For quick start and usage examples, please refer to . Requirements Dependency Version Requirement Node.js = 18.0.0 TypeScript = 5.0.0 (Recommended) Runtime Support: Node.js (Recommended) Bun Deno Installation Or use other package managers: Environment Variables Variable Name Description Required CodeBuddy CLI executable path Optional Authentication Configuration The SDK supports authentication using existing login credentials, API Key, or OAuth Client Credentials. See for details. Functions query() Main API entry point that creates a query and returns a message stream. Parameters: Parameter Type Description Query prompt or user message stream Configuration options (optional) Return Value: Interface that extends Query Interface Constants Errors Unstable V2 API Warning: The following APIs are experimental and may change in future versions. unstablev2createSession() Create a new interactive session. unstablev2resumeSession() Resume an existing session. unstablev2prompt() Convenience function for single query. unstablev2authenticate() Initiate an interactive login flow with support for multi environment authentication (international, China, etc.). Parameters: Field Type Description Authentication URL callback, used to open a browser or display the link Predefined environment (mutually exclusive with endpoint) Custom endpoint URL (for selfhosted, mutually exclusive with environment) Authentication method ID, default Timeout in milliseconds, default 300000 CLI executable path (optional) Environment variables (optional) Returns: User info object containing userId, userName, userNickname, token, and other fields Example: Behavior: If a valid token already exists, returns user info directly without triggering the login flow Otherwise, notifies the user to open the login link via the callback Aft"},{"id":"/cli/sdk-hooks","title":"SDK Hook System","body":"SDK Hook System Version Requirements: This documentation is for CodeBuddy Agent SDK v0.1.0 and above. This document explains how to use the Hook system in the SDK to insert custom logic before and after tool execution. Table of Contents Overview Hooks allow you to insert custom logic during CodeBuddy's session lifecycle, enabling: Validation and interception before tool calls Logging after tool execution Review of user submitted content Initialization and cleanup at session start/end Custom workflows for creation and cleanup Supported Events Event Trigger Timing Before tool execution After successful tool execution When user submits a message When main Agent response ends When sub agent ends Before context compression When creating an isolated When deleting an isolated When a checkpoint is automatically created after file modifications Hook Configuration Configure hooks through the option. Each event can have multiple matchers, and each matcher can have multiple hook callbacks. Basic Structure ::: code group ::: HookMatcher Structure Field Type Description Match pattern, supports regex. or empty string matches all Array of callback functions Timeout (milliseconds in TypeScript, seconds in Python) Matcher Patterns Exact match: only matches Bash tool Regex match: matches Edit or Write Wildcard: or matches all tools Prefix match: matches all MCP tools Event Types PreToolUse Triggered before tool execution, can block execution or modify input. ::: code group ::: PostToolUse Triggered after successful tool execution, can add extra context. ::: code group ::: UserPromptSubmit Triggered when user submits a message, can add context or block processing. ::: code group ::: Stop / SubagentStop Triggered when Agent response ends, can block stopping and request continuation. ::: code group ::: unstableCheckpoint (Experimental) Automatically triggered after file modifications (when Write/Edit/MultiEdit tools execute successfully), providing file snapshots and change statistics. :"},{"id":"/cli/sdk-permissions","title":"SDK Permission Control","body":"SDK Permission Control Version Requirement: This document is for CodeBuddy Agent SDK v0.1.0 and above. This document explains how to implement permission control in the SDK, including permission modes, canUseTool callbacks, and tool whitelists/blacklists. Table of Contents Overview CodeBuddy Agent SDK provides multiple permission control mechanisms: Mechanism Description Use Case Permission Modes Global permission behavior control Quick setup of overall policy canUseTool Callback Runtime dynamic approval Interactive permission confirmation Tool Whitelists/Blacklists Declarative tool filtering Static policy configuration Permission Modes Set global permission behavior through (TypeScript) or (Python). Available Modes Mode Description Default mode, all tool operations require confirmation Auto approve file edits, other operations still require confirmation Planning mode, only read only tools allowed Skip all permission checks (use with caution) Initial Configuration ::: code group ::: Dynamically Modifying Permission Mode Using Session/Client API allows you to dynamically modify permission mode at runtime: ::: code group ::: canUseTool Callback The callback is triggered when a tool requires permission confirmation, allowing you to implement custom permission logic. Callback Signature ::: code group ::: Complete Example: Interactive Approval ::: code group ::: Modifying Tool Input You can modify tool input parameters in : ::: code group ::: Handling AskUserQuestion When AI needs to ask the user a question, it calls the tool. You need to handle this tool in . Input Structure Returning Answers ::: code group ::: Tool Whitelists/Blacklists Use and to declaratively control tool access. Configuration Example ::: code group ::: Common Tool Names Tool Name Functionality Read files Write files Edit files File pattern matching Content search Execute shell commands Sub agent tasks Fetch web content Web search Best Practices 1. Use mode by default: Provides the most complete perm"},{"id":"/cli/sdk-sessions","title":"SDK Session Management","body":"SDK Session Management Version Requirement: This document is for CodeBuddy Agent SDK v0.1.0 and above. This document explains how to manage sessions in the SDK, including obtaining session IDs, resuming sessions, forking sessions, and multi turn conversations. Table of Contents Overview Session is a core concept in CodeBuddy, used for: Maintaining conversation context: AI can remember previous content in multi turn conversations Supporting session resumption: Can continue from where you left off Supporting session forking: Create branches from a certain point to explore different directions Each session has a unique that can be used for subsequent resumption. Obtaining Session ID When a session starts, the SDK returns an initialization message of type containing the . Using query API ::: code group ::: Using v2 Session API (TypeScript) Using Client API (Python) Resuming Sessions Using a previously saved allows you to resume a session and continue the previous conversation. Using resume option ::: code group ::: Continuing the most recent session Using the / option automatically continues the most recent session: ::: code group ::: Multi turn Conversations Multi turn conversations allow multiple interactions within the same session while maintaining context coherence. TypeScript: Using query API Each new query call uses to resume the session: TypeScript: Using v2 Session API v2 API provides a more concise multi turn conversation experience: Python: Using CodeBuddySDKClient Related Documentation Quick start and usage examples Permission modes and canUseTool Complete API reference Complete API reference"},{"id":"/cli/sdk-custom-tools","title":"SDK Custom Tools Guide","body":"SDK Custom Tools Guide Version Requirement: This documentation is for CodeBuddy Agent SDK v0.2.0 and above. Feature Status: SDK Custom Tools is a Preview feature of the CodeBuddy Agent SDK. This document explains how to create and use custom tools in the CodeBuddy Agent SDK. Custom tools allow you to define specialized functionality that Agents can invoke to complete specific tasks. Overview Custom Tools is a way provided by the CodeBuddy Agent SDK to create custom tools through MCP (Model Context Protocol). Unlike configuring external MCP servers, Custom Tools allows you to define tools directly within your application without requiring a separate process or server. Core Advantages In process Execution: Tools execute within the application, no need to create separate processes Type Safety: Full TypeScript type checking and type inference support Simplified Deployment: No need to deploy MCP servers separately, everything deploys with the application Tight Integration: Share memory and state with the application Zero Additional Dependencies: Leverages existing SDK infrastructure Quick Start TypeScript Create a simple calculator tool: Python Python SDK uses decorator pattern for defining tools: Creating Custom Tools TypeScript Basic Tool Definition TypeScript Complete Example: File Analysis Tool Python Decorator Pattern Managing Multiple Tools TypeScript Python Type Safety TypeScript Using Zod Schema Zod provides runtime type validation and powerful type inference: Python Type Annotations Python SDK uses standard type annotations: Complete Example: Database Query Tool TypeScript Python Complete Example: API Integration Tool TypeScript Python Selectively Allowing Tools You can selectively allow specific tools to be called: TypeScript Python Error Handling TypeScript API Call Error Handling Python API Call Error Handling Best Practices 1. Use Clear Parameter Types and Descriptions Provide clear types and descriptions for tool parameters to help of the Agent understand h"},{"id":"/cli/sdk-mcp","title":"SDK MCP Integration Guide","body":"SDK MCP Integration Guide Version Requirement: This documentation is for CodeBuddy Agent SDK v0.1.24 and above. Feature Status: SDK MCP support is a Preview feature of the CodeBuddy Agent SDK. This document explains how to integrate and use MCP (Model Context Protocol) servers in the CodeBuddy Agent SDK, extending your applications with custom tools and functionality. Overview MCP servers allow you to integrate custom tools, resources, and prompts into the CodeBuddy Agent SDK. Through the SDK, you can programmatically enable these tools, adding domain specific capabilities to your AI workflows. Core Concepts MCP Server: A standalone process or service that provides tools, resources, and prompts Tools: Executable functions exposed by MCP servers Resources: Readable data or files provided by MCP servers Prompts: Templated prompts provided by MCP servers Supported Transport Types CodeBuddy Agent SDK supports three MCP server communication methods: Transport Type Use Case Description STDIO Local tools Communicate with local processes via standard input/output HTTP/SSE Remote services Communicate with remote services via HTTP streaming or Server Sent Events SDK MCP IDE/SDK integration MCP servers registered by external SDKs (like IDE extensions) Configuring MCP Servers supports two configuration methods: 1. Object format: Define server configuration directly in code 2. File path string: Point to an MCP configuration file (JSON format) Object Format Use the option to configure MCP servers. Configuration supports STDIO, HTTP, and SSE transport types. TypeScript: Python Python: File Path Format You can also pass an MCP configuration file path. The configuration file is in JSON format, with the same structure as the CLI parameter. TypeScript: Python: Configuration file format example ( ): Note: When using file path format, SDK MCP type ( ) server configuration is not supported. SDK MCP servers are only available in object format. Server Configuration Details STDIO Configurat"},{"id":"/cli/sdk-demos","title":"SDK Demo Projects","body":"SDK Demo Projects This document introduces the official demo projects for CodeBuddy Agent SDK, helping you quickly understand various SDK usage scenarios. Demo Repository All demo code is hosted in the official repository: Repository URL: <https://cnb.cool/codebuddy/agent sdk demos Demo Overview Demo Language Core Features Use Case quick start TypeScript Basic API, Message Streaming, Hooks SDK Getting Started multi turn session TypeScript Multi turn Conversations, Session Recovery Interactive Applications research assistant Python Multi Agent Collaboration Complex Task Decomposition profile builder TypeScript Web Search, Document Generation Information Collection chat demo TypeScript WebSocket, Streaming Response Web Applications mail assistant TypeScript MCP Protocol, Custom Tools Business System Integration spreadsheet assistant TypeScript Electron IPC Desktop Applications Environment Setup Prerequisites or Node.js 18+ Python 3.10+ (for Python demos) CodeBuddy CLI login authentication completed Install SDK ::: code group ::: Authentication Methods SDK supports multiple authentication methods: 1. Reuse CLI Login State: If you have logged in via the command, SDK automatically uses existing credentials 2. API Key Authentication: Configure via environment variables For detailed authentication configuration, please refer to Basic Demos quick start: SDK Getting Started Demonstrates basic usage of the API, including message stream handling and Hooks mechanism. Run Demo: multi turn session: Multi turn Conversations Demonstrates Session API for multi turn conversations and session recovery. Run Demo: Advanced Demos research assistant: Multi Agent Collaboration Python demo showing how to define multiple specialized sub agents collaborating on complex tasks. Workflow: 1. Main Agent breaks down research requests into subtasks 2. Researcher uses WebSearch to gather information, saves to 3. Data Analyst extracts data from research notes, generates charts to 4. Report Writer con"},{"id":"/cli/release-notes/README","title":"Release Notes","body":"Release Notes Release notes for CodeBuddy Code, covering feature updates and improvements for end users. About Release Notes Release Notes document user visible changes in each version, including: New Features Improvements Bug Fixes Difference from CHANGELOG.md: Release Notes: User facing, emphasizing feature value and user experience CHANGELOG: Developer facing, recording technical details and code changes Version History <! New versions are automatically added here 2026 04 08 2026 04 08 2026 04 07 2026 04 07 2026 04 05 2026 04 05 2026 04 04 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 02 2026 04 01 2026 04 01 2026 03 31 2026 03 31 2026 03 30 2026 03 30 2026 03 28 2026 03 26 2026 03 26 2026 03 25 2026 03 25 2026 03 25 2026 03 24 2026 03 23 2026 03 23 2026 03 19 2026 03 18 2026 03 18 2026 03 17 2026 03 17 2026 03 16 2026 03 15 2026 03 13 2026 03 13 2026 03 13 2026 03 12 2026 03 12 2026 03 12 2026 03 12 2026 03 11 2026 03 11 2026 03 11 2026 03 09 2026 03 07 2026 03 06 2026 03 06 2026 03 05 2026 03 05 2026 03 03 2026 03 03 2026 03 02 2026 02 28 2026 02 28 2026 02 28 2026 02 26 2026 02 26 2026 02 25 2026 02 24 2026 02 19 2026 02 19 2026 02 14 2026 02 14 2026 02 13 2026 02 13 2026 02 12 2026 02 12 2026 02 11 2026 02 11 2026 02 11 2026 02 10 2026 02 10 2026 02 09 2026 02 08 2026 02 06 2026 02 05 2026 02 04 2026 02 04 2026 02 04 2026 02 03 2026 02 03 2026 02 02 2026 02 02 2026 02 02 2026 01 31 2026 01 31 2026 01 30 2026 01 30 2026 01 29 2026 01 28 2026 01 28 2026 01 28 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 26 2026 01 26 2026 01 25 2026 01 25 2026 01 24 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 22 2026 01 22 2026 01 22 2026 01 22 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 20 2026 01 20 2026 01 20 2026 01 20 2026 01 19 2026 01 18 2026 01 17 2026 01 17 2026 01 16 2026 01 15 2026 01 15 2026 01 15 2026 01 14 2026 01 14 2026 01 13 2026 01 12 2026 01 09 2026 01 09 2026 01 08 2026 01 08"},{"id":"/cli/release-notes/v2.81.0","title":"🚀 CodeBuddy Code v2.81.0 Release","body":"🚀 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"},{"id":"/cli/release-notes/v2.80.0","title":"🚀 CodeBuddy Code v2.80.0 Release","body":"🚀 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 toolcalls, improving compatibility with more OpenAI compatible APIs WeChat Work Group Chat Optimization: Support for group chat me"},{"id":"/cli/release-notes/v2.79.1","title":"🚀 CodeBuddy Code v2.79.1 Release","body":"🚀 CodeBuddy Code v2.79.1 Release ✨ New Features Daemon Persistent Mode & Background Sessions Added Daemon process support, manageable via commands for background running CLI instances. Also supports the parameter to start tasks in the background, with 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 ( ) retains the original limitation Setti"},{"id":"/cli/release-notes/v2.79.0","title":"🚀 CodeBuddy Code v2.79.0 Release","body":"🚀 CodeBuddy Code v2.79.0 Release ✨ New Features Daemon Mode & Background Sessions Added Daemon process support, allowing you to manage background running CLI instances via commands. Also supports the flag to launch tasks in the background, with commands for full lifecycle management of background tasks. Web UI Workers & Log Management The Web UI now includes a Workers page for visual management of all Worker processes and Daemons, supporting start, stop, and terminate operations. Also added a standalone log viewer supporting 4 log types (telemetry/process/debug/conversation) switching, keyword search, and syntax highlighting. System Monitoring View The Web UI now includes a Metrics page displaying system CPU, memory, and disk usage overview, as well as per instance process level resource metrics (RSS, Heap, uptime), with 8 second auto polling refresh to help you stay on top of resource status at all times. Editor Experience Major Upgrade Tab Enhancements: Support drag to reorder, pinned tabs (Pin), overflow scroll arrows, and an 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 Cmd+P / Ctrl+P to quickly search and open files File Preview: Support image preview (zoom/drag/checkerboard background), Markdown, PDF, SVG preview, and binary file info pages Status Bar: Bottom bar displays cursor position, selection info, language type, and other editing status Recent Files: Empty editor page shows a list of recently opened files 🔧 Improvements Execution Phase Tracking: The 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 Background Task Support Expansion: stream json and headless modes now support background tasks; only print mode ( ) retains its origina"},{"id":"/cli/release-notes/v2.78.1","title":"🚀 CodeBuddy Code v2.78.1 Release","body":"🚀 CodeBuddy Code v2.78.1 Release 🐛 Bug Fixes Agent Resolution Fix: Fix the issue where the wrong Agent was used during queue drain and Agent wake up. Now the session associated Agent is used consistently, ensuring more accurate and reliable task scheduling Model Field Fix: Fix the model field value issue for reasoningitem and regular items. Actual model response information is now used instead of potentially empty values, ensuring complete and accurate model information 🔧 Improvements WeCom Reply Enhancement: Enhanced chatId parsing to support extracting routing information from chatId strings; optimized tool return format to structured JSON, improving message processing reliability"},{"id":"/cli/release-notes/v2.78.0","title":"🚀 CodeBuddy Code v2.78.0 Release","body":"🚀 CodeBuddy Code v2.78.0 Release ✨ New Features Agent Teams Web UI Support A brand new Agent Teams Web UI experience that lets you intuitively manage and monitor multi Agent collaborative tasks in the browser: Real time Progress Tracking: Team members' running status, token usage, and tool invocation counts are pushed in real time via SSE, giving you an at a glance overview in the task panel Member Conversation Viewer: Click any member to view their complete conversation history with real time streaming updates Smart Message Display: Incoming messages show , outgoing messages show , with each member having a unique color identifier State Recovery on Refresh: Team state and member conversations are automatically restored after page refresh, no manual reconnection needed Full Internationalization: Added 13 Team related translations in both Chinese and English 🔧 Improvements Permission System Refactor: Refactored ACP permission broadcast mechanism to support restoring permission dialogs after Web UI page refresh, fixing cross client permission sync issues Questionnaire Delivery Optimization: AskUserQuestion is now delivered via the interruption broadcast protocol, preventing questionnaires from being sent to the wrong client in multi connection scenarios Context Compaction Improvement: Replaced manual truncation with a synchronous compact flow, improving the reliability of context management Channel Message Queue: Added a message queue mechanism for WeChat/WeCom channels to prevent concurrent message loss while an Agent is running Option Compatibility Handling: Added defensive handling for plain string option arrays in TUI and Web UI questionnaire panels 🐛 Bug Fixes Command Completion Fix: Fix the issue where the completion menu disappears after typing a slash command followed by arguments. Now typing something like still correctly shows command completion suggestions Command Suggestion Fix: Fix the issue where command completion keeps showing after the cursor moves"},{"id":"/cli/release-notes/v2.77.1","title":"🚀 CodeBuddy Code v2.77.1 Release","body":"🚀 CodeBuddy Code v2.77.1 Release 🔧 Improvements Image Blob Reference Rehydration: Added the environment variable. When set to , image blob references are automatically rehydrated to full base64 data during mode streaming output, facilitating downstream system integration WeChat/WeCom Permission Reply UX Optimization: Removed mechanical confirmation messages after permission operations; Agent's subsequent actions now serve as implicit feedback, making conversations more natural and fluent 🐛 Bug Fixes WeChat/WeCom Message Routing Fix: Fix a bug where the \"Always Allow\" directive in permission replies was incorrectly recognized due to a check order issue, ensuring permission directives are correctly prioritized"},{"id":"/cli/release-notes/v2.77.0","title":"🚀 CodeBuddy Code v2.77.0 Release","body":"🚀 CodeBuddy Code v2.77.0 Release ✨ New Features Plugin System Major Upgrade The plugin system has received a major enhancement, significantly improving plugin installation, management, and extensibility: Multi source Installation: Support installing plugins via npm packages and Git repository subdirectories, flexibly adapting to different plugin distribution methods MCP Bundle Support: Support loading pre packaged MCP services (.mcpb/.dxt/.zip) from remote URLs or local files, simplifying MCP service integration Output Style Extension: Plugins can provide custom output styles to personalize Agent output presentation Default Agent Configuration: Plugins support setting a default Agent via , serving as the lowest priority base layer PATH Auto injection: Enabled plugins' directories are automatically injected into the Bash tool's PATH User Configuration Options: Plugins support defining fields for interactive user configuration collection during installation Dependency Resolution: Support DFS closure algorithm for resolving plugin transitive dependencies, including cycle detection Plugin Security & Management Marketplace Name Protection: Four layer defense mechanism to prevent third party impersonation of the official marketplace Enterprise Policy Service: Control plugin enable/disable via managed settings to meet enterprise compliance requirements Flag: Support loading plugins from a local directory for development and testing Command: Reload all plugin components without restarting Command: Four layer validation of plugin directory structure and manifest validity 🔧 Improvements Venus Endpoint Compatibility Adapter: Support Prompt cache injection and request field sanitization for Venus OpenAI compatible proxy endpoints; model adapters and endpoint adapters can be stacked SDK MCP Tool Filter: Ensure permission and deny rules are correctly applied to custom tools registered via the SDK 🐛 Bug Fixes AskPanel Race Condition Fix: Fix the invocation order issue between d"},{"id":"/cli/release-notes/v2.76.0","title":"CodeBuddy Code v2.76.0 Release","body":"CodeBuddy Code v2.76.0 Release New Features GLM 5v Turbo Model Launch: Added GLM 5v Turbo multimodal vision model with image understanding capabilities, enabling the AI assistant to analyze and understand image content. Simultaneously launched on both the domestic and iOA versions Bug Fixes Model Temperature Configuration Fix: Fixed an issue where the temperature parameter for some models was incorrectly hardcoded to the default value of 1. Now correctly reads the temperature value specified in the product configuration for each model, ensuring models run with optimal parameters"},{"id":"/cli/release-notes/v2.75.0","title":"CodeBuddy Code v2.75.0 Release","body":"CodeBuddy Code v2.75.0 Release Improvements WeChat Instance ID Dynamic Update: After WeChat client QR code authentication, the temporary instance ID is automatically updated to the real ID, ensuring subsequent message replies are correctly routed to the corresponding WeChat account WeChat Message Send Error Checking: Added return value validation to the message sending interface, throwing clear error messages on send failure to facilitate troubleshooting"},{"id":"/cli/release-notes/v2.74.0","title":"CodeBuddy Code v2.74.0 Release","body":"CodeBuddy Code v2.74.0 Release New Features Side Question Command /btw Use to quickly ask a side question while the Agent is working, without interrupting the current task. Answers are generated instantly based on the existing context, making it easy to confirm details or get supplementary information during complex tasks. Improvements Channel Session Suggestion Confirmation: After completing a conversation round through WeChat/WeCom channels, follow up suggestions are automatically generated and wait for user confirmation before execution, preventing unnecessary automated actions Bug Fixes AskUserQuestion Panel Stability: Fixed an issue where the question and answer panel could crash when the model returned incomplete option data"},{"id":"/cli/release-notes/v2.73.0","title":"CodeBuddy Code v2.73.0 Release","body":"CodeBuddy Code v2.73.0 Release New Features Channel Suggestion Confirmation After completing a conversation round through WeChat/WeCom channels, the system automatically generates next step action suggestions and sends them to the user for confirmation. Reply with \"y\" to continue execution, making channel interactions smoother and more natural. Improvements WeChat/WeCom Three Option Permissions: Permission request prompts upgraded from to , supporting remembered choices to reduce repetitive confirmations Permission Deadlock Fix: Replying with non option content in WeChat/WeCom no longer causes a deadlock; the system automatically denies the current permission and processes the input as a new message Context Compaction Optimization: Automatically cleans up stale tool results older than 1 hour before compaction, reducing compaction input tokens by 80%+ in practice and significantly lowering compaction costs Image Content Stripping: Automatically replaces images with placeholders before compaction, preventing meaningless image tokens from entering the summary Compaction Prompt Enhancement: Improved 9 section structured summary format for better compaction quality and information retention JSON Repair Enhancement: Replaced custom repair logic with the jsonrepair library, supporting repair of Chinese quotes, missing commas, truncated JSON, and more malformed scenarios, reducing unnecessary model retries Bug Fixes Channel Message Slash Commands: Fixed an issue where slash commands sent from WeChat and other channels were wrapped in tags and could not be correctly recognized Queue Message Command Preservation: Slash commands are now preserved during message queue processing and executed through the normal pipeline once the agent is idle, preventing commands from being silently dropped"},{"id":"/cli/release-notes/v2.72.0","title":"🚀 CodeBuddy Code v2.72.0 Release","body":"🚀 CodeBuddy Code v2.72.0 Release ✨ New Features File Changes Panel The Web UI now includes a Changes view that lets you see all files modified by the Agent in real time. Click any file to open the Monaco Diff Editor, which displays the specific changes for each file with syntax highlighting. Checkpoint Rollback Added powerful code rollback capabilities with three flexible rollback modes: Per file revert: Precisely revert changes to a single file Checkpoint rollback: Return to a previous conversation node Multi mode selection: Roll back code only, conversation only, or both 🔧 Improvements Diff Viewing Upgrade: Migrated from custom diff algorithm to Monaco DiffEditor with syntax highlighting support and smoother large file viewing File Icon Optimization: Eliminated icon flickering during loading for smoother file list display Session State Restoration: Automatically restores the file changes panel state after page refresh, preserving context Real time Change Notifications: All connected clients receive real time notifications when the Agent modifies files Plugin Management API: Added public REST APIs for managing plugin installation, uninstallation, enabling, and disabling Configuration Management API: Added public REST APIs for querying and modifying configuration with scope based operations Clipboard Compatibility Enhancement: Added JXA NSPasteboard fallback for macOS image pasting, improving compatibility with third party screenshot tools like WeCom Message Notification Optimization: Improved Chinese descriptions for tool operations in WeChat and WeCom Channels for better readability"},{"id":"/cli/release-notes/v2.71.1","title":"CodeBuddy Code v2.71.1 Release","body":"CodeBuddy Code v2.71.1 Release Improvements SDK MCP Timeout Mechanism: Replaced fixed timeouts with an AbortSignal cancellation mechanism, supporting long running MCP tool calls and preventing complex tools from being unexpectedly interrupted by timeouts Reasoning Model Configuration: Automatically defaults effort to high when thinking mode is enabled, ensuring the model actually produces reasoning output Product Configuration Fix: Corrected a typo in the reasoning field of the model configuration"},{"id":"/cli/release-notes/v2.71.0","title":"CodeBuddy Code v2.71.0 Release","body":"CodeBuddy Code v2.71.0 Release New Features Web UI Code Editor The Web UI now includes file browsing and code editing capabilities, allowing you to view and edit project files directly in the browser: Directory Tree Navigation: The left panel displays the project file structure for quick file access Multi Tab Editing: Open multiple files simultaneously and switch freely between tabs Monaco Editor: Integrated with the same editor engine as VS Code, with syntax highlighting support Auto Save: Edits are automatically saved without manual action File Drag & Drop: Support for moving files via drag and drop Keyboard Shortcuts: Common keyboard shortcuts supported for improved editing efficiency Improvements Streaming Timeout Optimization: Increased the default streaming response timeout and first token timeout from 2 minutes to 10 minutes, reducing timeout interruptions during complex tasks caused by slower model responses. Can still be customized via and environment variables"},{"id":"/cli/release-notes/v2.70.1","title":"CodeBuddy Code v2.70.1 Release","body":"CodeBuddy Code v2.70.1 Release Security Fixes CORS Cross Origin Attack Protection Fixed a cross origin request security vulnerability in the local Gateway service ( ). Previously, malicious web pages could use JavaScript to make cross origin requests to the user's local localhost service, executing Agent commands or stealing output data. Key fixes: Replaced the framework's default with a precise allowlist mechanism, only permitting cross origin requests from localhost, 127.0.0.1, and Tunnel URLs Added Host header validation middleware to prevent DNS Rebinding attacks Fixed CORS wildcard vulnerability on SSE streaming endpoints Changed the default bind address from to to prevent the service from being exposed to the local network Improvements Custom CORS Rules: Support configuring allowed cross origin sources via the environment variable (comma separated) or the Settings option, accommodating special use cases"},{"id":"/cli/release-notes/v2.70.0","title":"CodeBuddy Code v2.70.0 Release","body":"CodeBuddy Code v2.70.0 Release New Features Model Driven Built in Command Invocation AI models can now directly execute certain built in slash commands (such as /clear, /model, /config, /resume, /gateway, etc.) through the Skill tool, enabling model proxied command execution in non terminal scenarios like WebChat and WeChat without requiring users to manually type slash commands. Commands like /model, /config, /resume now support a subcommand to display available options in text format The field provides unified control over whether built in and custom commands can be invoked by the model Improvements Instance Registration URL Simplification: Merged localUrl/tunnelUrl into a unified url field, with the backend automatically determining the best reachable address, simplifying configuration Permission Dialog Stability: Replaced the useEffect subscription pattern with useSyncExternalStore, completely resolving the race condition that occasionally prevented permission dialogs from appearing Session Permission Mode Persistence: Fixed the issue where permission mode was reset when switching sessions in multi instance scenarios"},{"id":"/cli/release-notes/v2.69.0","title":"CodeBuddy Code v2.69.0 Release","body":"CodeBuddy Code v2.69.0 Release New Features E2B Compatible API Fully aligned with the E2B open protocol, allowing CodeBuddy Code to be used as an E2B compatible sandbox environment: File System API: Added and endpoints, supporting file read/write, directory operations, file watching, and other comprehensive file system capabilities Process Management API: Added endpoints, supporting process launching (PTY/pipe), input/output streaming, signal sending, and full lifecycle management System Metrics & Environment Variables API: Added and endpoints, providing CPU/memory/disk usage metrics and environment variable queries Improvements PTY Terminal Enhancement: Added SSE output streaming, HTTP input sending, and HTTP resize endpoints, providing a pure HTTP alternative to WebSocket Terminal Web UI Refactoring: Migrated the frontend terminal component from WebSocket to SSE + HTTP communication, improving cross platform compatibility Distributed Tracing: Refactored the trace pipeline based on the Hook mechanism, supporting SDK passed traceId for end to end tracing with automatic child Span creation for each tool call WeChat Multi Instance Support: Enabled simultaneous connections to multiple WeChat bot instances with automatic message routing to the correct client WeChat Media Messages: Added support for receiving and sending images, files, voice, and video messages Chinese Quotation Mark Fix: Automatically corrects Chinese quotation marks in model output to prevent JSON parsing failures in tool calls Security Fixes WeCom SSRF Protection: Added URL allowlist validation for WeCom bot media downloads, restricting access to official WeCom CDN domains only to prevent Server Side Request Forgery attacks"},{"id":"/cli/release-notes/v2.68.0","title":"🚀 CodeBuddy Code v2.68.0 Release","body":"🚀 CodeBuddy Code v2.68.0 Release ✨ New Features Web UI Documentation Viewer Added a documentation browsing feature in the Web UI, allowing you to access CLI documentation without leaving your workspace: Full text search for quickly locating the content you need Language switching between Chinese and English to suit different preferences Table of contents navigation and TOC for easy browsing of long documents API Reference quick links for direct access to Swagger UI Support for opening in a new tab as a standalone full screen view CLI documentation is automatically bundled at build time, supporting offline viewing 🔧 Improvements HTTP API Standardization: All public endpoints unified under the prefix with version control support; internal endpoints migrated to for a clearer structure API Documentation: Added Swagger UI ( ) and OpenAPI specification ( ) for developers to explore and debug APIs Unified Response Format: Public endpoints adopt the standard / envelope format, improving API consistency ACP Endpoint Migration: ACP protocol endpoints migrated from to , unifying the routing prefix with REST APIs Credential Storage Optimization: WeChat and WeCom credentials consolidated into a single file format, with automatic migration from legacy formats API Response Compatibility: Web UI adapted to the unified envelope format, ensuring correct parsing of REST endpoint responses 🐛 Bug Fixes Confirmation Dialog Display: Fixed an issue where the AskUserQuestion confirmation dialog occasionally failed to appear, resolving a race condition in route navigation Documentation Link Format: Corrected the format of localhost links in the Channels documentation"},{"id":"/cli/release-notes/v2.67.0","title":"🚀 CodeBuddy Code v2.67.0 Release","body":"🚀 CodeBuddy Code v2.67.0 Release ✨ New Features WeCom Channel Bridge WeCom AI Bot messages can now be injected directly into Agent sessions through the channel system, with support for replying with markdown formatted messages using the WeComReply tool, covering both group chat and private chat scenarios. Multi Instance Access and Management Both WeChat and WeCom support connecting multiple bot instances simultaneously Interactively add and manage connections through the panel WeChat binds directly via QR code scanning, WeCom auto connects after entering Bot ID + Secret, with credentials persisted to disk Web UI Remote Control Management Added a remote control page with visual management of channel connections (connect/disconnect/unbind/delete), including WeChat QR scanning and WeCom form based addition. WeCom Media Message Support WeComReply tool now supports uploading and sending media messages including images, files, and videos Supports receiving image and file messages sent by users with automatic download and decryption Improved image and file message handling for WeChat Customer Service 🔧 Improvements Environment variable control for max turns: Support controlling the maximum execution turns for the main Agent and sub Agents separately via and environment variables WeCom media decryption: Aligned with the official SDK using AES 256 CBC algorithm, added automatic format detection 🐛 Bug Fixes Rewind phantom diff: Fixed the issue where rewind after compact showed non existent file changes; compact messages now correctly inherit file snapshot state PTY file descriptor leak: Enhanced fd cleanup logic for PTY service and background tasks, ensuring proper resource release even on error paths"},{"id":"/cli/release-notes/v2.66.2","title":"🚀 CodeBuddy Code v2.66.2 Release","body":"🚀 CodeBuddy Code v2.66.2 Release 🐛 Bug Fixes Model settings sync: Fixed an issue where options were not synchronized when setting the model via SDK/control signals, ensuring model selection remains consistent across all read paths"},{"id":"/cli/release-notes/v2.66.1","title":"🚀 CodeBuddy Code v2.66.1 Release","body":"🚀 CodeBuddy Code v2.66.1 Release 🔧 Improvements Channel permission relay: Supports confirming tool permission requests via Channels (such as WeChat). Channels that declare permission relay capability no longer force auto approval, instead forwarding confirmation requests to the user WeChat permission confirmation: When tool execution requires permissions, a natural language confirmation request is sent via WeChat message, and the user can approve or reject by replying y/n WeChat Q&A support: The AskUserQuestion tool can send question options via WeChat, and users can select answers by replying with a number or free text WeChat plan confirmation: When ExitPlanMode is triggered, the plan summary is automatically read and presented to the user for confirmation via WeChat before execution begins 🐛 Bug Fixes WeChat Channel reply tool: Fixed an intermittent issue where the reply tool could not be found, eliminating race conditions during the connection process WeChat Q&A duplicate prompts: Fixed an issue where AskUserQuestion sent both a Q&A message and a permission confirmation message simultaneously WeChat Q&A parameter parsing: Fixed an issue where Q&A parameters in JSON string format were not parsed correctly"},{"id":"/cli/release-notes/v2.66.0","title":"🚀 CodeBuddy Code v2.66.0 Release","body":"🚀 CodeBuddy Code v2.66.0 Release ✨ New Features Thinking Mode Enabled by Default Thinking mode is now globally enabled by default, providing enhanced reasoning capabilities without manual configuration. Complex code analysis and multi step task processing are now more accurate. 🐛 Bug Fixes Token counter: Fixed the token counter in the bottom right corner always displaying 0 Status bar cost display: Fixed the status bar script receiving incorrect cost data Status bar initialization: Fixed the status bar potentially not rendering on first display Context percentage: Fixed inaccurate context usage percentage display when approaching the limit Memory leak: Fixed status bar manager subscriptions not being properly cleaned up"},{"id":"/cli/release-notes/v2.65.1","title":"🚀 CodeBuddy Code v2.65.1 Release","body":"🚀 CodeBuddy Code v2.65.1 Release 🐛 Bug Fixes Headless Mode Execution Stability Removed the fixed 60 second forced exit logic in headless mode to prevent long running CLI, SDK, or automation scripts from being prematurely terminated before task completion. Long running requests are no longer incorrectly interrupted by fixed timeouts Improved execution stability in non interactive invocation scenarios Better suited for continuous running or externally awaiting automation workflows"},{"id":"/cli/release-notes/v2.65.0","title":"🚀 CodeBuddy Code v2.65.0 Release","body":"🚀 CodeBuddy Code v2.65.0 Release ✨ New Features Channel Messaging Support receiving messages from external sources (such as WeCom bots, WeChat customer service, etc.) via the MCP protocol, enabling multi channel message aggregation and processing. The startup screen automatically displays the list of configured Channels Channel sourced messages are displayed in a user friendly format during conversations Security controls including sender whitelisting and permission relay are supported 🔧 Improvements Background task control in non interactive mode: Automatically disables background execution parameters in headless, SDK, and print modes to prevent unmanageable background tasks in non interactive environments 🐛 Bug Fixes Background task PTY leak: Fixed an issue where PTY file descriptors were not released when background tasks were terminated, preventing system resource exhaustion during prolonged operation"},{"id":"/cli/release-notes/v2.64.2","title":"🚀 CodeBuddy Code v2.64.2 Release","body":"🚀 CodeBuddy Code v2.64.2 Release 🔧 Improvements Simplified Login Flow: Removed intranet environment detection logic at startup. All login methods (including iOA) are now always displayed without waiting for network detection China Edition Model Ordering: Adjusted the display order of the glm 5.0 series in the China edition model list for a better selection experience 🐛 Bug Fixes Repeated Context Compression: Fixed an issue where compression was immediately re triggered after completion, preventing unnecessary repeated compression cycles and improving long conversation stability Session Persistence Error: Fixed an issue where externalized large tool results were incorrectly synced back into memory, causing the model to fail to understand tool outputs. Tool results are now correctly saved and read"},{"id":"/cli/release-notes/v2.64.1","title":"CodeBuddy Code v2.64.1","body":"CodeBuddy Code v2.64.1 Bug Fixes Terminal Split Screen Stability: Fixed an issue where split screen operations could unexpectedly reset the terminal. PTY sessions are now only destroyed when the user explicitly closes the panel Message Bubble Filtering: Fixed an issue where internal system tag content occasionally appeared in user message bubbles, ensuring a clean interface display"},{"id":"/cli/release-notes/v2.64.0","title":"CodeBuddy Code v2.64.0","body":"CodeBuddy Code v2.64.0 New Features Comprehensive Web UI Enhancements The Web UI receives a comprehensive upgrade, delivering a brand new user experience: Redesigned Interface: Redesigned sidebar navigation, status bar, and login page with a unified visual style and interaction experience Multiple Views: Added history sessions, task management, plugin management, and other views for better information organization Brand Loading Animation: New paw print brand loading animation replacing the generic spinner Terminal Improvements: Support for terminal title display, with automatic theme color refresh on theme switch Instance Management Enhancement: Optimized instance management panel layout and interaction Cross Session Switching: The command supports cross session switching, with Web UI synchronization Improvements Large Tool Result Externalization: When tool results exceed 50KB, they are automatically saved to disk with a summary retained in conversation history, preventing unbounded memory growth in long running sessions Agent Task Memory Cleanup: Periodically cleans up completed task records and expired team member session references, fixing memory leaks in long running scenarios Diagnostics Panel Enhancement: The panel now includes memory usage and task statistics for easier resource troubleshooting TLS Verification Skip: Fixed the issue where disabling TLS verification did not take effect in non proxy scenarios Sub Agent Tool Rename: Renamed the Task tool to Agent, with the name more accurately reflecting its functionality ACP Stream Optimization: Delayed POST stream closure mechanism to resolve notification loss in tunnel scenarios Gateway Security Prompt: Added risk warnings and network access configuration guidance Message Queue Fix: Preserve queue messages when canceling requests to avoid losing queued messages Token Usage Fix: Fixed inflated percentages after compression causing repeated compression Rewind Fix: Prioritize pre modification file state for rest"},{"id":"/cli/release-notes/v2.63.5","title":"🚀 CodeBuddy Code v2.63.5 Release","body":"🚀 CodeBuddy Code v2.63.5 Release 🔧 Improvements Telemetry Control: Support disabling telemetry data reporting via environment variable for enhanced privacy control flexibility Image Format Detection: Support detecting image MIME types via file magic bytes, enabling correct format identification even when the file extension does not match the actual content"},{"id":"/cli/release-notes/v2.63.4","title":"🚀 CodeBuddy Code v2.63.4 Release","body":"🚀 CodeBuddy Code v2.63.4 Release 🔧 Improvements SDK Scenario Stability: Disabled automatic CLI updates in SDK mode to prevent subsequent requests from returning instantly due to process restart, improving reliability for SDK integration scenarios Session Recovery Reliability: Fixed message consumption anomalies caused by incorrect cleanup of historical messages during session reinitialization, ensuring normal message processing after session recovery Subagent Progress Display Optimization: Changed token statistics in subagent and Team member progress from cumulative consumption to current context window size, providing a more intuitive view of real time context usage E2E Test Enhancement: Client automatically responds to AskUserQuestion, command name validation now supports Unicode characters"},{"id":"/cli/release-notes/v2.63.3","title":"🚀 CodeBuddy Code v2.63.3 Release","body":"🚀 CodeBuddy Code v2.63.3 Release 🔧 Improvements Subagent Context Compression Fix: Fixed the issue where subagents could not resume after context compression, ensuring stability for subagent execution in long conversation scenarios Context Compression Quality Improvement: Fixed the issue where internal tags might leak into summarized content during compression, improving the accuracy of compressed context"},{"id":"/cli/release-notes/v2.63.2","title":"🚀 CodeBuddy Code v2.63.2 Release","body":"🚀 CodeBuddy Code v2.63.2 Release 🔧 Improvements Timeout Retry Enhancement: First token timeout now supports up to 2 retries with linear delay (2s/4s), improving recovery success rate during network fluctuations Message Queue Processing: Fixed an issue where accumulated user messages in the queue could not be processed after timeout error handling, ensuring smooth conversation flow State Consistency: Fixed race conditions in state reset logic during error handling, ensuring correctness of retries and queue processing"},{"id":"/cli/release-notes/v2.63.1","title":"🚀 CodeBuddy Code v2.63.1 Release","body":"🚀 CodeBuddy Code v2.63.1 Release 🐛 Bug Fixes Malformed JSON Context Pollution Fix: Fixed an issue where retry prompt messages were not cleaned up in time when the AI model occasionally generated malformed tool call parameters. Previously, these prompt messages were repeatedly sent to the model in every subsequent conversation turn, causing context pollution and unnecessary token consumption. After the fix, retry prompts are automatically cleaned up in the next conversation turn, keeping the conversation context clean"},{"id":"/cli/release-notes/v2.63.0","title":"🚀 CodeBuddy Code v2.63.0 Release","body":"🚀 CodeBuddy Code v2.63.0 Release ✨ New Features Disable TLS Verification Support disabling TLS certificate verification for HTTPS requests via a product feature toggle. This is designed for private deployment environments using self signed certificates or internal CA certificates, allowing connections without additional system certificate configuration. 🔧 Improvements Plugin Marketplace Tracking: Added tracking events for plugin marketplace operations, supporting actions such as marketplace add/remove/refresh, plugin install/uninstall/enable/disable, to help optimize the plugin ecosystem experience Centrifugo Connection Strategy: Disabled Centrifugo auto connection in favor of on demand manual startup, reducing unnecessary network overhead Configuration Panel Cleanup: Removed deprecated Wecom configuration items from the /config panel for a cleaner interface 🐛 Bug Fixes Auto Retry Race Condition Fix: Fixed an issue where the event was emitted prematurely during network error auto retry, causing the parent task to incorrectly determine that the sub agent had failed Timeout Duration Optimization: Increased streaming timeout and first token timeout from 60 seconds to 120 seconds, reducing false disconnections in weak network environments Context Compression Stability: Fixed an issue where abort signal cascading during compression caused the session to freeze, improving reliability in long conversation scenarios"},{"id":"/cli/release-notes/v2.62.1","title":"🚀 CodeBuddy Code v2.62.1 Release","body":"🚀 CodeBuddy Code v2.62.1 Release 🔧 Improvements Context Compression Optimization: Refactored the compression summary injection mechanism so that compressed context is restored in a more structured way, improving context coherence in long conversations. Also raised the auto compression trigger threshold to reduce unnecessary compression interruptions. The compression process no longer mixes in system rules and memory content, ensuring more accurate summaries SDK Communication Stability: Fixed multiple stability issues in the SDK communication layer, including concurrent write interleaving, permission requests hanging after disconnection, and incomplete interrupt responses. The Python SDK enhanced JSON buffer fault tolerance, and the JS SDK improved backpressure handling WeCom Bot Interaction Experience: Replaced static text with streaming messages for processing status display, automatically replacing with final results upon completion for a cleaner chat history 📝 Documentation Updates WeCom Bot Documentation Navigation: Unified sidebar titles for related documentation and fixed duplicate entries in the Chinese version"},{"id":"/cli/release-notes/v2.62.0","title":"🚀 CodeBuddy Code v2.62.0 Release","body":"🚀 CodeBuddy Code v2.62.0 Release ✨ New Features Delegate Tool Support (Experimental) Added the DelegateTool, which allows Agents to invoke delegate tools registered by external clients (such as Web UI or IDE plugins) to enable UI querying and UI control capabilities. This provides more flexible extensibility for integrating CodeBuddy Code with external toolchains. 🔧 Improvements Remote Control Refactoring: Unified the command into a general purpose command, supporting unified management of multiple long lived connection clients, with a new interactive UI panel for quick client connection selection Fast Local Command Execution for Remote Control: Added a mechanism to quickly detect local commands, avoiding unnecessary waiting prompts for local commands like and Enhanced Model Compatibility: Added an OpenAI model adapter to automatically handle incompatible parameters; the Gemini adapter now includes JSON Schema field cleanup, fixing 400 errors caused by tool parameters Stream Timeout Optimization: Adjusted the default stream timeout from 30 seconds to 60 seconds, with new smart detection to prevent completed responses from being incorrectly identified as timed out Bash Tool Description Optimization: Provided clearer description examples for complex commands and refined the dangerous command list Memory Path Structure: Aligned project memory directories to the standard path structure, fixing incomplete path display in menus 🐛 Bug Fixes ACP Session Management: Fixed an issue where newSession requests reused old sessions by default, switching to an explicit field to control session reuse behavior AbortController Leak: Unified usage of to prevent listener accumulation warnings during long sessions"},{"id":"/cli/release-notes/v2.61.3","title":"🚀 CodeBuddy Code v2.61.3 Release","body":"🚀 CodeBuddy Code v2.61.3 Release 🔧 Improvements Improved Startup Stability: Fixed startup failures caused by authentication initialization timeout and asynchronous initialization of the remote control service during CLI startup, improving cold start success rate Moonshot Model Compatibility: Optimized tool message content parsing logic to prevent plain string arrays (such as file path lists) from being incorrectly converted to content blocks, improving tool call stability for Moonshot models Plugin Update Mechanism Optimization: Switched to a fetch + reset strategy instead of pull, resolving plugin update failures when the local and remote branches of the plugin Git repository diverge SDK Interaction Fix: Fixed an issue where interactive tools (such as AskUserQuestion) were unexpectedly disabled in SDK mode, while ensuring interactive tools are properly disabled in Print mode Web Search Upgrade: Migrated to the new search API with optimized response parsing and error handling 🐛 Bug Fixes Third Party API Connection Fix: Fixed an issue where the Authorization header was incorrectly removed when connecting to third party APIs using mode, causing 401 errors. Also filters headers to avoid 400 errors"},{"id":"/cli/release-notes/v2.61.2","title":"🚀 CodeBuddy Code v2.61.2 Release","body":"🚀 CodeBuddy Code v2.61.2 Release 🔧 Improvements WeCom AI Bot WebSocket Compatibility: Migrated WebSocket implementation to the W3C standard API, supporting both Bun and Node.js runtimes for improved cross platform compatibility WeCom AI Bot Auto Connect: Added startup parameter to automatically connect to WeCom AI Bot on launch, eliminating the need to manually run the command"},{"id":"/cli/release-notes/v2.61.1","title":"🚀 CodeBuddy Code v2.61.1 Release","body":"🚀 CodeBuddy Code v2.61.1 Release 🔧 Improvements SDK Version Update: Upgraded Agent SDK JS to 0.3.81, keeping the SDK in sync with the CLI version"},{"id":"/cli/release-notes/v2.61.0","title":"🚀 CodeBuddy Code v2.61.0 Release","body":"🚀 CodeBuddy Code v2.61.0 Release ✨ New Features Memory System Overhaul Shortcut for Saving Memories: The shortcut now saves memories to , with support for selecting either Project or User scope, providing more flexible management of personal and project level preferences. Auto Memory Independent Control: A new management panel has been added, supporting independent toggling of Auto Memory. It can also be switched via the panel. Typed Memory (Experimental): Supports 4 structured memory types ( / / / ) and YAML frontmatter format for more organized memory management. /memory Command with Arguments: Supports saving memories directly via command arguments, without needing to navigate to the management page. 🔧 Improvements Decoupled Tool Search and Execution: ToolSearch now returns the full parameter schema for the agent to execute, keeping the context prefix stable to improve KV cache hit rates. Context Management Optimization: Lowered the token usage warning threshold so context compression triggers earlier, reducing degradation in conversation quality caused by excessively long contexts. Shell Performance Optimization: Optimized the PTY fd leak detection mechanism to avoid blocking the event loop. WeCom Bot Timeout Fix: Adopted a two phase reply mechanism to avoid the 30s streaming timeout issue, allowing long running Agent tasks to return results correctly. Web UI Session Sync: When is executed or a new conversation is created in the Web UI, the CLI terminal view refreshes in sync. File Path Completion: The Web UI input box now supports triggered file path completion, automatically adding a space after selection. Prompt Suggestions: The Web UI now displays prompt suggestions generated on the CLI side; press Tab to quickly accept them. 🐛 Bug Fixes Tool Call Retry: Fixed an issue where invalid JSON parameters returned by the model caused an immediate 400 error. The model is now informed of the specific JSON parse error and retries automatically. Sub agent Hook Isola"},{"id":"/cli/release-notes/v2.60.0","title":"🚀 CodeBuddy Code v2.60.0 Release","body":"🚀 CodeBuddy Code v2.60.0 Release ✨ New Features WeCom Bot Remote Control Supports remotely controlling CodeBuddy Agent via WeCom AI Bot persistent connection — no public IP required. Use the command to quickly connect. The remote control module has also been refactored into an extensible multi client registration architecture, making it easier to integrate additional IM platforms in the future. 🔧 Improvements Custom Model Auth Error Optimization: When a custom model returns a 401 error, automatic logout is no longer triggered. A targeted API Key check prompt is provided instead. When the specified model does not exist, the list of models available under the current account is automatically displayed. Resume Session Panel: The currently active session is highlighted in green with a checkmark, making it easy to identify at a glance. Web Slash Command Handling: Removed client side slash command interception — all command logic is now handled uniformly by the server. 🐛 Bug Fixes Image History Restoration: Fixed a timing issue with image blob reference tracking to ensure correct deduplication of historical images, preventing unresolved blob references from being sent to the model. Nested Skills Loading: Fixed an issue where directories containing sub Skills could not be discovered and loaded. Also increased the scan depth limit to support deeper nested structures. Skip Internal Request Headers: Fixed an issue where the environment variable had no effect, ensuring internal request headers are correctly stripped when connecting to third party gateways. Tracing Initialization: Fixed a \"No API key provided for OpenAI tracing exporter\" error appearing in some users' terminals."},{"id":"/cli/release-notes/v2.59.0","title":"🚀 CodeBuddy Code v2.59.0 Release","body":"🚀 CodeBuddy Code v2.59.0 Release ✨ New Features Hook Driven Worktree Support Provides isolated workspace capability for non Git version control systems such as SVN and Perforce. Through the and Hook events, you can fully customize the creation and cleanup logic for worktrees, no longer limited to Git repositories: Even in a Git repository, if Hook is configured, the Hook based approach takes priority Hook based worktrees always display the keep/delete menu on exit, preventing errors in non Git projects caused by missing Git commands Worktree Base Branch Specification The parameter now supports using to specify the base branch: Supports both remote branches ( ) and local branches ( ) Automatically falls back to the remote default branch with a warning when the specified branch does not exist, without interrupting the startup process The tool now supports the parameter as well 🔧 Improvements Plan Mode Approval: Fixed an issue where the ExitPlanMode tool could not correctly display plan content when approving in the Web UI. Users can now see the complete plan content and permission request list in the approval dialog Image Read Deduplication: Fixed an issue where an image at the same path was incorrectly deduplicated after being modified. The system now correctly detects file updates and returns the latest image content Worktree Hook Compatibility: Completed the SDK protocol and documentation for and , ensuring custom worktree hooks receive full context and can integrate stably 🐛 Bug Fixes ACP Connection Cleanup: Fixed an issue where old connections were not properly cleaned up when starting a new chat, causing broadcast messages to be rendered multiple times"},{"id":"/cli/release-notes/v2.58.0","title":"🚀 CodeBuddy Code v2.58.0 Release","body":"🚀 CodeBuddy Code v2.58.0 Release ✨ New Features WeChat KF & WeCom Remote Gateway Added support for WeChat KF (WeChat Customer Service) and WeCom (Enterprise WeChat) platform integrations. Supports receiving messages and sending replies via Webhook callbacks. The WeChat KF adapter includes full capabilities: callback signature verification, AES encryption/decryption, syncmsg message polling, and automatic customer service account creation. 🔧 Improvements Python SDK Authentication Enhancement: Added standalone authentication APIs ( / ), supporting two phase login flow; refactored control request mechanism to support request response matching and timeout handling Python SDK Type Improvements: Added type definitions for , , , and more SDK Error Diagnostics: Python SDK added startup crash detection and stderr capture; JS SDK improved process exit reason tracking and error type exports Headless Mode Stability: Refactored module exports to a three layer structure, eliminating IoC resolution failures in headless builds Tunnel Connection Optimization: Forced HTTP/2 over QUIC for better compatibility; support for detached cloudflared process reuse across sessions; added tunnel state.json to manage concurrent multi port tunnels Plugin Marketplace Auto Update: Added enable/disable auto update toggle on marketplace detail pages; built in marketplace defaults to enabled, third party marketplaces default to disabled Config Cache Isolation: Fixed an issue where temporary CLI parameters (e.g., ) would pollute the configuration cache Web UI Improvements: History playback now displays images in user messages with zoom in support; sub agents support collapse/expand; tool calls are uniformly clickable Web UI Bun SFE Compatibility: Support for embedding static files into Bun single file executables, compatible with resource loading in flat mode Gateway Command Experience: Added loading animation when starting the Gateway service to prevent repeated user actions Task Progress Display: O"},{"id":"/cli/release-notes/v2.57.1","title":"🚀 CodeBuddy Code v2.57.1 Release","body":"🚀 CodeBuddy Code v2.57.1 Release 🔧 Improvements Headless Mode Scheduled Task Support Headless mode now includes the export of scheduled task capabilities. In scripts, SDK, and server side integration scenarios, you can use scheduled task features more directly, reducing the need for additional wrappers and integration overhead. Supports direct access to scheduled task capabilities in headless integration scenarios Brings feature parity between scripts, SDK, and the interactive CLI"},{"id":"/cli/release-notes/v2.57.0","title":"🚀 CodeBuddy Code v2.57.0 Release","body":"🚀 CodeBuddy Code v2.57.0 Release ✨ New Features Remote Gateway (Beta) A brand new remote control feature that allows you to remotely access your CodeBuddy Code CLI session from any device via Cloudflare Tunnel. It comes with a full featured Web UI, including: Remote terminal panel with split screen layout and real time WebSocket communication Interactive Q&A panel for answering Agent questions directly from the Web UI Visual display of conversation compression and Team progress Secure authentication and multi client synchronization Scheduled Tasks Create scheduled tasks to let CodeBuddy automatically perform repetitive work on a set schedule. Simply define execution intervals using cron expressions, with support for viewing and canceling created tasks. 🔧 Improvements Hook Output Collapse Configuration: Added the setting, which can be configured via the panel to control whether Hook output is collapsed by default First Token Timeout Detection Optimization: Now detects meaningful model output instead of raw responses, preventing server heartbeats from invalidating timeout detection, with enhanced retry mechanism stability Sub agent MCP Inheritance: Sub agents can now correctly use MCP server tools configured by the parent agent Fish Shell Keyboard Compatibility: Fixed unresponsive key input in Fish shell 3.4+ when used with terminals supporting the Kitty keyboard protocol Tool Search Parameter Optimization: Enhanced parameter descriptions to provide better usage guidance 🐛 Bug Fixes API Error Response Handling: Fixed an issue where the UI would freeze when the API returned errors (e.g., rate limiting) MCP OAuth Authentication: Fixed OAuth Provider cache lookup failures to ensure a stable and reliable authentication flow Memory Leak Warning: Fixed MaxListenersExceededWarning caused by abort listeners exceeding the limit during long running sessions Streaming Output Format: Fixed formatting and completeness issues with JSON output Hooks Chinese Encoding: Fixed garble"},{"id":"/cli/release-notes/v2.56.1","title":"🚀 CodeBuddy Code v2.56.1 Release","body":"🚀 CodeBuddy Code v2.56.1 Release 🐛 Bug Fixes Conversation Compression Display: Fixed the completion detection logic for compressed conversation groups by checking for the presence of an assistant reply instead of a fixed message count, preventing abnormal compression state display in edge cases"},{"id":"/cli/release-notes/v2.56.0","title":"🚀 CodeBuddy Code v2.56.0 Release","body":"🚀 CodeBuddy Code v2.56.0 Release ✨ New Features Worktree PR Support Support for creating worktrees from CNB (Code Nebula Buddy) platform PR links, including domains such as cnb.woa.com and cnb.cool. Within a worktree, you can directly perform code review and modifications based on a PR. 🔧 Improvements New GPT 5.4 model: Supports 272K input, 128K output, with reasoning and image capabilities MCP panel optimization: Removed borders, grouped server list by configuration source, added diagnostic information display for a cleaner and more intuitive interface Model compatibility layer: Added a model compatibility handler that automatically adapts API request format differences for third party models such as Gemini and Moonshot, reducing manual configuration Error diagnostics enhancement: Improved error logging for model requests and SDK Transport, supporting streaming error response body reading and process close reason capture for easier troubleshooting Tool search optimization: Split search and activate operations into separate parameters for clearer invocation; unmatched tool names now automatically fall back to fuzzy search User query identification: Added tag wrapping for user messages to help models more accurately distinguish actual user queries from system context content 📝 Documentation Updates MCP environment variable expansion documentation: Added documentation for environment variable expansion usage, including syntax descriptions, supported configuration fields, examples, and common use cases"},{"id":"/cli/release-notes/v2.55.1","title":"🚀 CodeBuddy Code v2.55.1 Release","body":"🚀 CodeBuddy Code v2.55.1 Release 🔧 Improvements MCP environment variable defaults: MCP configuration now supports the syntax, automatically using the specified default value when an environment variable is not set, simplifying MCP server configuration Worktree initialization improvements: Enhanced symlink creation logic with automatic file/directory type detection and conflict handling; improved file processing for better performance in large repositories Hooks Windows path compatibility: Fixed path parsing issues when executing hooks via Git Bash on Windows where backslashes caused failures, now uniformly converting to Unix style paths 🐛 Bug Fixes SDK authentication fix: Fixed an issue where the authentication URL was incorrectly overwritten during login Environment configuration protection: Fixed an issue where network environment settings explicitly configured by users via or were automatically overridden SessionStart hook race condition fix: Fixed an issue where the first message could be processed before the SessionStart hook completed, causing injected context to be lost"},{"id":"/cli/release-notes/v2.55.0","title":"🚀 CodeBuddy Code v2.55.0 Release","body":"🚀 CodeBuddy Code v2.55.0 Release ✨ New Features Git Worktree Support The new Worktree feature allows you to develop in parallel across isolated working directories without interference: Use the flag to launch an isolated development environment for safe experimental changes Combine with the flag to run in a dedicated tmux session, ideal for long running tasks Agents can dynamically create and enter worktrees during a session via the EnterWorktree tool Sub agent tasks automatically inherit the worktree working directory, ensuring correct file operation paths Supports and event hooks for custom VCS integration Automatically detects changes on exit and provides clear action options; worktrees with no changes are cleaned up automatically 🔧 Improvements Tool search optimization: ToolSearch now supports both search and activate modes — search mode displays activated tools and candidates in a layered view, while activate mode enables precise activation by name Status bar line wrapping: Long text in the status bar now wraps automatically instead of being truncated Diff wide character handling: Fixed inaccurate line wrapping in the Diff view when content contains wide characters such as Chinese text or Emoji Message identification optimization: Improved user message identification logic to exclude teammate messages automatically sent by the framework"},{"id":"/cli/release-notes/v2.54.0","title":"🚀 CodeBuddy Code v2.54.0 Release","body":"🚀 CodeBuddy Code v2.54.0 Release ✨ New Features Skills Nested Subdirectories Skills can now be organized using subdirectories within the directory. Nested Skills automatically generate colon delimited qualified names (e.g., ), and short name matching is also supported, making Skills management more flexible and organized. 🔧 Improvements Startup optimization: Eliminated redundant execution during PromptContext initialization; concurrent requests now reuse the same initialization result, improving startup speed Model selection optimization: Improved model selection mechanism across different agent modes, enhancing configuration flexibility MCP config environment variable expansion: placeholders in MCP server configurations are now automatically replaced with the corresponding environment variable values. Supports command/args/env for stdio and url/headers for SSE/HTTP transports. Missing variables are left as is with a diagnostic message generated Context compaction stability: Fixed an issue where message enqueuing during automatic compaction prevented compaction from executing, and improved robustness of interrupt waiting. Also fixed internal continuation messages displaying incorrectly in the chat UI during compaction Vim word motion enhancement: Word motions (w/b/e) in Vim mode and keybindings now correctly support CJK characters, treating each CJK character as an individual word Gzip compression optimization: Gzip compression is now automatically skipped when a custom API endpoint is configured or when a model uses a custom URL, preventing request failures caused by third party services that do not support gzip Hook output encoding fix: Fixed garbled error messages from Hook scripts on Chinese Windows systems /skills panel enhancement: The Skills panel now also displays custom slash commands, with group headers showing the source directory path. Token counting now only includes the description portion, avoiding misconceptions about context usage Truncation retry"},{"id":"/cli/release-notes/v2.53.0","title":"🚀 CodeBuddy Code v2.53.0 Release","body":"🚀 CodeBuddy Code v2.53.0 Release ✨ New Features WeCom Remote Control Support remote control of CLI via WeCom (WeChat Work), enabling task dispatching and result pushing from mobile devices. Manage your development tasks anytime, anywhere from your phone, no longer limited to operating in front of a terminal. 🔧 Improvements MCP Dynamic Tool Updates: Support notifications from MCP servers, automatically refreshing the tool list when changes occur without requiring a restart or manual reconnection Reasoning Effort Configuration: Added a Reasoning Effort setting in the /config panel, supporting five levels: auto/low/medium/high/xhigh, to customize model reasoning depth Status Bar Enhancement: Added session name, permission mode, context window usage, and other fields with multi line rendering support and style optimizations LSP Server Lazy Loading: LSP servers now use lazy loading by default, starting only on first use to reduce resource consumption at startup Error Tracking Enhancement: WebSearch and ImageGen tools now include requestId in error messages when API calls fail, making it easier to diagnose issues Non Interactive Mode Optimization: Improved prompt messages when tool permissions are denied in print mode, providing clear bypass instructions File Auto Completion Refresh: Fixed an issue where newly added files were not suggested when typing ; the file list cache now automatically refreshes after expiration Skill Tool Result Optimization: Improved result message formatting after Skill and slash command execution for clearer output Hook Input Processor: Added extension point to support injecting context fields before Hook execution ACP Error Handling: Improved error message transmission in ACP mode, allowing clients to receive more detailed error status codes 🐛 Bug Fixes Conversation History Restoration: Fixed an issue where context before compaction was lost when resuming a session after executing compact Team Abort Signal Isolation: Sub agents no longer lis"},{"id":"/cli/release-notes/v2.52.6","title":"🚀 CodeBuddy Code v2.52.6 Release","body":"🚀 CodeBuddy Code v2.52.6 Release 🔧 Improvements Model Request Logging Enhancement: Added comprehensive request lifecycle logging, covering key events including request sending, first token arrival, streaming progress, completion/error/timeout, enabling quick issue identification via requestId and agent name Runtime Warning Elimination: Fixed the MaxListenersExceededWarning that appeared during long conversations by implementing a unified abort controller management utility, improving stability in long sessions Hook Message Rendering Enhancement: Hook messages now display different icons and colors based on execution status (success/blocked/warning/error), with support for expanding/collapsing to view detailed content, improving readability"},{"id":"/cli/release-notes/v2.52.5","title":"🚀 CodeBuddy Code v2.52.5 Release","body":"🚀 CodeBuddy Code v2.52.5 Release 🔧 Improvements Image History Optimization Image data in conversation history is now deduplicated and stored via BlobStore. Only the most recent N turns retain full image data, while earlier turns are automatically replaced with text placeholders, significantly reducing context token consumption. When the same image is read multiple times within the same conversation turn, a reference prompt is returned instead of resending the full data. Theme System Refactoring Expanded the theme color system to support semantic colors (such as success, warning, error, info, etc.) with enhanced terminal color compatibility. Added ChalkFactory for intelligent terminal capability detection, automatic color level adaptation, and support for color blind friendly themes. Gzip Compression Compatibility Fix: Fixed an issue where request bodies were incorrectly compressed during enterprise address login; gzip compression is now only enabled in SaaS and iOA environments Custom Model URL Handling: Automatically appends the suffix to custom model URLs, so users no longer need to manually construct the full path Bash Timeout Configuration: Supports dynamic configuration of the Bash tool timeout via settings env 🐛 Bug Fixes Hooks Command Execution: Fixed an issue where hook commands containing quotes, such as , failed to execute Logout Race Condition Fix: Fixed an issue where async operations were not terminated in time during logout, causing the session to be written back Conversation Compression Identifier Correction: Fixed an issue where the conversation identity was misidentified after async context compression, ensuring compressed messages are correctly attributed to the main conversation"},{"id":"/cli/release-notes/v2.52.4","title":"🚀 CodeBuddy Code v2.52.4 Release","body":"🚀 CodeBuddy Code v2.52.4 Release 🔧 Improvements First Token Timeout Detection Added a timeout detection mechanism for the first response data after a request is sent. The connection is automatically disconnected and retried upon timeout, preventing prolonged unresponsive waits. The stream data monitoring interval has been reduced from 10 seconds to 1 second, improving the detection speed of abnormal connections. Custom timeout durations can be configured via the and environment variables. Request Compression Added support for gzip compression of API request bodies, reducing network bandwidth consumption and improving response speed on slow networks. CLI Subcommand Aliases: Added shorthand aliases for , , and ; added option for and macOS Code Signing: Fixed an issue on macOS 26+ where missing TeamIdentifier caused the system to terminate multiple running instances MCP Tool Hooks Fix: Resolved an issue where PreToolUse/PostToolUse hooks for MCP tools failed to trigger correctly Tool Call Truncation Retry: Optimized the retry mechanism for tool call parameters truncated due to model output exceeding limits, improving retry success rate Hook Permission Prompt Optimization: When a PreToolUse Hook returns an ask decision, the decision reason is now displayed as a warning in the permission confirmation dialog Paste Behavior Optimization: Pasting text content no longer automatically detects whether it is an image path and converts it; pasted text is always inserted as is Shell Configuration Unification: Removed support for PowerShell and CMD, requiring Windows users to use Git Bash Model Upgrade: Upgraded the Gemini Pro model from version 3.0 to version 3.1 🐛 Bug Fixes Input History Navigation: Fixed an issue where pressing the up arrow to browse history would stop scrolling after reaching an entry starting with Tool Permission Denial Rendering: Fixed an issue where tool calls could not be properly rendered in the UI when rejected by PreToolUse hooks or permission rules "},{"id":"/cli/release-notes/v2.52.3","title":"🚀 CodeBuddy Code v2.52.3 Release","body":"🚀 CodeBuddy Code v2.52.3 Release 🔧 Improvements Gemini Image Generation Models: Added three new image generation models — Gemini 3.0 Pro Image, Gemini 3.1 Flash Image, and Gemini 2.5 Flash Image — supporting both text to image and image to image generation Ctrl+D Exit Optimization: Ctrl+D now only triggers the double press exit flow when the input box is empty and there is no ongoing conversation, preventing accidental exits Windows Shell Compatibility: Fixed Shell path selection logic and shell snapshot functionality on Windows, ensuring Git Bash is preferred; improved configuration file detection and encoding handling; correctly identifies non POSIX shells such as fish and tcsh MCP Configuration Enhancement: The parameter now supports both file paths and direct JSON format; MCP servers with non project scope skip the approval check, reducing unnecessary confirmation prompts Dependency Upgrade: Upgraded OpenAI Agents SDK to 0.5.2 and OpenAI SDK to v6 🐛 Bug Fixes Plugin List Display: Fixed an issue where plugin skills failed to load correctly after cache clearing"},{"id":"/cli/release-notes/v2.52.2","title":"🚀 CodeBuddy Code v2.52.2 Release","body":"🚀 CodeBuddy Code v2.52.2 Release 🔧 Improvements Custom Token Authentication: Supports recognizing custom token authentication configuration from the ACCPRODUCTCONFIG environment variable; fixed an authentication fallback issue when the configuration was loaded but synchronization had not yet completed Session Loading Performance Optimization: The command now uses parallel reads when loading historical sessions, reducing wait time Plugin Loading Speedup: Parallelized the plugin loading process, improving startup speed by several times in multi plugin scenarios 🐛 Bug Fixes /doctor Command: Fixed an issue where a null session could cause a property access error SDK Python Build Script: Updated the goreleaser output directory path to match headless build artifact naming; removed unused imports"},{"id":"/cli/release-notes/v2.52.1","title":"🚀 CodeBuddy Code v2.52.1 Release","body":"🚀 CodeBuddy Code v2.52.1 Release 🔧 Improvements Startup & Stability Instant Version Query: / no longer triggers the full initialization process, significantly improving response speed Pipe Environment Compatibility: Subcommands no longer wait for stdin input in non TTY environments, preventing process hangs Authentication Timeout Protection: Authentication initialization automatically times out when the network is unreachable, preventing the CLI from waiting indefinitely Team Member Switching Experience Instant Switching: Use left/right arrow keys to instantly switch team member views without pressing Enter, making the operation smoother Quick Enter/Exit: Press the down arrow key to enter selection mode with @main selected by default; press the up arrow key or Esc to exit Input History Isolation: History navigation and member selection mode no longer interfere with each other; clearing the input box automatically exits history navigation SDK Improvements Python SDK MCP Server Simplification: Server objects can now be passed directly without manually constructing a dictionary JS SDK Executable Configuration: Custom CLI executable file paths and arguments are now supported via and Internal Request Header Filtering: Internal request headers can be cleaned up via the environment variable to avoid interfering with third party API gateways 🐛 Bug Fixes Skill Loading: Fixed an issue where Skills from plugins occasionally failed to load, ensuring correct initialization order Skill Invocation: Fixed an issue where Skills with could not be automatically invoked by the model Team Member Colors: Fixed duplicate color index assignment when generating Team members concurrently Sub agent Concurrency Stability: Fixed MaxListenersExceededWarning caused by a large number of concurrent sub agents"},{"id":"/cli/release-notes/v2.52.0","title":"🚀 CodeBuddy Code v2.52.0 Release","body":"🚀 CodeBuddy Code v2.52.0 Release ✨ New Features Team View Switching Quickly switch between different team member views using arrow keys. Press to enter switching mode, to select a member, and to confirm and switch to that member's view, allowing you to check conversation history and work progress in real time. The highlight preview and input box border color automatically sync when switching, keeping you informed of each member's work status at all times. Headless Mode Added a lightweight headless build (45% smaller in size), supporting , , and for quick startup, ideal for CI/CD pipelines and automation integration scenarios. 🔧 Improvements Major Startup Performance Boost: Optimized the startup flow, reducing Application.start() time by 96% and memory usage by 31%, delivering a much smoother startup experience Bun Native Optimization: Replaced third party dependencies (PTY, glob, semver, etc.) with Bun native APIs, improving runtime performance Dependency Reduction: Removed unused dependencies to reduce installation size Authentication Timing Fix: Ensured authentication completes before API calls, eliminating occasional 401 errors during cold starts Model Sorting Optimization: Adjusted default model priority order for the China edition, making commonly used models easier to select Command Execution Stability: Optimized command execution and environment initialization flow, reducing execution interruptions under abnormal conditions Authentication Experience Enhancement: Improved the robustness of the API Key Helper token acquisition process, enhancing authentication flow stability Error Handling Upgrade: Upgraded error handling from string matching to custom error classes, improving error identification reliability Stream Timeout Auto Retry: Automatically retries when model streaming responses time out, requiring no manual intervention. Supports customizing timeout duration via the environment variable Command Suggestion Filtering: Skills that cannot be invoked dir"},{"id":"/cli/release-notes/v2.51.2","title":"🚀 CodeBuddy Code v2.51.2 Release","body":"🚀 CodeBuddy Code v2.51.2 Release 🔧 Improvements New Model Support: Added Gemini 3.0 Pro and Gemini 3.0 Flash model configurations. You can now use these two latest generation Google models in the model selector, enjoying stronger reasoning capabilities and faster response speeds"},{"id":"/cli/release-notes/v2.51.1","title":"🚀 CodeBuddy Code v2.51.1 Release","body":"🚀 CodeBuddy Code v2.51.1 Release 🔧 Improvements Ctrl+N/P Key Mapping: Added support for Ctrl+N/Ctrl+P as alternatives to ↓/↑ arrow keys, working across all scenarios including input fields, selection menus, and confirmation panels, providing a smoother experience for users accustomed to Emacs keybindings Loading State Token Display Optimization: Fixed the issue where token count displayed as 0 while the main agent waited for a subagent; now correctly shows real time streaming token changes. Both subagent and Team member progress rows support real time streaming token display Session Level Permission Sync: When selecting \"Don't ask again for this session\" during sub agent execution, the permission is now synced to the main session and all sub agents, avoiding repeated permission confirmation prompts MCP Connection Timeout Protection: Added timeout mechanism for MCP server connection waits, preventing indefinite hangs in headless mode when a server is unresponsive Team Notification Optimization: Refactored background task completion notifications to use a mailbox based delayed deduplication mechanism, preventing duplicate notifications from interrupting conversation flow; fixed queue messages losing sender identity New Model Support: Added GPT 5.3 Codex model configuration Agent Teams Setting Display: Agent Teams default state in the settings panel now correctly displays as enabled 🐛 Bug Fixes Custom Commands Override Built in Commands: Fixed the issue where custom slash commands and Skills could not override built in commands with the same name; now correctly follows project level user level built in priority order Startup UI Rendering: Fixed welcome Banner duplicate rendering and the display issue where the trust dialog overlapped with Banner content Background Task Query: Fixed the \"not found\" error when querying via TaskOutput after a background Agent was launched"},{"id":"/cli/release-notes/v2.51.0","title":"🚀 CodeBuddy Code v2.51.0 Release","body":"🚀 CodeBuddy Code v2.51.0 Release 🎉 New Features Memory Directory Summary Added memory file list summary in the system prompt, displaying file names, sizes, modification dates, and first line titles. The AI assistant can now see at a glance which memory files you have and load relevant content on demand, avoiding stuffing all memory file contents into the context and significantly reducing Token consumption. Automatic Memory File Cleanup Memory files are now cleaned up alongside session history cleanup, reusing the same retention period configuration. No more worrying about the directory growing indefinitely. 🔧 Improvements Skills Support Inline Shell Commands: Skills' SKILL.md now supports ! syntax to execute Shell commands, maintaining a consistent processing pipeline with slash commands, making Skills authoring more flexible Skill Slash Command Dispatch: Support invoking registered Skills directly via or , with automatic fallback to Skill lookup when no built in command matches, improving command usage fluency Slash Command Menu Optimization: Descriptions are automatically truncated when too long, preventing menu items from spanning multiple lines for a cleaner interface YAML Parsing Enhancement: Support for folded block scalar syntax ( , ), correctly folding multi line descriptions into a single line Model Coefficient Update: Updated billing coefficients for all models to the latest values, added support for additional models, ensuring more accurate billing 🐛 Bug Fixes Confirmation Dialog Scroll Fix: Fixed an issue where the scrollbar would automatically jump to the top when permission confirmation dialogs, plan confirmation dialogs, and edit confirmation dialogs exceeded the terminal height, providing a smoother experience for confirming long content Custom Sub agent Tool Inheritance: Fixed an issue where custom sub agents would inherit the ability to create sub agents when no tool list was configured, preventing unintended recursive calls"},{"id":"/cli/release-notes/v2.50.7","title":"CodeBuddy Code v2.50.7 Release","body":"CodeBuddy Code v2.50.7 Release Improvements Team Member Focus Navigation When using Team collaboration, you can now navigate between members using Shift+Up/Down to switch views, viewing each member's conversation history, execution progress, and token consumption in real time. Press Ctrl+O to quickly return to the main view. Direct Member Messaging: After focusing on a member, the input box automatically switches to message sending mode for that member. Use @main to route messages back to the main agent Message Routing Enhancement: The SendMessage tool supports the \"main\" alias, and user message injection into member sessions no longer adds unnecessary XML wrapping Bug Fixes Sub agent AbortSignal Listener Leak: Fixed an issue where abort event listeners were registered and removed on the wrong AbortSignal in sub agents, eliminating error reports during cascading interrupts Member Session Recovery: Fixed subscription loss causing 0 tokens when sub agents restart, fixed race condition in agentend events"},{"id":"/cli/release-notes/v2.50.6","title":"CodeBuddy Code v2.50.6 Release","body":"CodeBuddy Code v2.50.6 Release Improvements High risk Command Detection Rules Optimization: Significantly reduced false positive rates, refined CRITICAL/HIGH/MEDIUM three tier risk assessment rules. Common development commands like , , , , etc. are no longer incorrectly blocked, improving daily development workflow Permission Rule Security Layering: Distinguished allow rules by source into trusted (user settings) and untrusted (project settings), preventing malicious repositories from injecting permission rules through project configuration files to bypass security checks, enhancing supply chain security protection Security Allowlist Expansion: Added 50+ common development tool commands to the security allowlist, covering build tools, testing frameworks, package managers, code quality tools, and more, reducing unnecessary authorization prompts Sub agent Model Configuration Optimization: Added relatedModels configuration for MiniMax M2.5 and Kimi K2.5 models, ensuring sub agents correctly select corresponding lightweight and reasoning model variants when using these models Bug Fixes Process Hang Fix: Fixed an issue where the process would not exit after terminal closure, causing 100% CPU usage Shell Handle Leak Fix: Fixed multiple Shell execution handles not being properly released, preventing PTY file descriptor leaks node pty fd Leak Fix: Detected and closed additional ptmx file descriptors leaked internally by node pty during dispose Diagnostics Enhancement: Added Active PTYs count to the /doctor panel for easier detection of potential PTY leaks"},{"id":"/cli/release-notes/v2.50.5","title":"CodeBuddy Code v2.50.5 Release","body":"CodeBuddy Code v2.50.5 Release New Features Bash Dedicated Sub agent Added a Bash built in sub agent focused on command line task execution. When the AI needs to perform git operations, run build tools, execute tests, or other terminal tasks, it automatically invokes a lightweight Bash sub agent for quick completion, improving command execution efficiency. Command Safety Detection Added Bash command injection detection mechanism that automatically identifies and blocks commands containing potentially dangerous constructs such as backtick substitution, command substitution, and newline injection, enhancing terminal operation security. Improvements Sub agent Tool Configuration Optimization: Adjusted the Plan sub agent toolset with new team collaboration tool support; streamlined the Explore sub agent tools, reducing unnecessary tool loading Sub agent Label Display Optimization: Unified sub agent names to use foreground color text display for a cleaner and more consistent visual appearance"},{"id":"/cli/release-notes/v2.50.4","title":"CodeBuddy Code v2.50.4 Release","body":"CodeBuddy Code v2.50.4 Release Improvements Background Task Experience Upgrade Background agents now automatically create lightweight teams and send results back via SendMessage, eliminating the need to manually poll with TaskOutput. Background tasks automatically notify the main agent upon completion, making the overall interaction smoother. UI progress display has also been unified, with background tasks integrated into TeammateProgressView for centralized display. Startup Performance Optimization: Optimized the initialization process during first launch, parallelized the registration flow, improving startup speed by approximately 10% Terminal Rendering Optimization: Unified all animation components to a single global clock driver, reducing terminal flickering caused by independent timers Message Rendering Fix: Fixed an issue where messages were not displayed after completion, requiring terminal resize to become visible Memory Leak Fix: Fixed an issue where caused the internal output buffer to accumulate indefinitely Task Cleanup Fix: Fixed an issue where failed subtasks were not properly cleaned up, leaving residual progress displays Bug Fixes Bash Tool Output Fix: Fixed an issue where occasional extra blank lines appeared below Bash tool execution results"},{"id":"/cli/release-notes/v2.50.3","title":"CodeBuddy Code v2.50.3 Release","body":"CodeBuddy Code v2.50.3 Release Bug Fixes Module Loading Compatibility Fix: Fixed an issue where failed to load modules in certain bundling environments due to being unavailable, improving runtime compatibility"},{"id":"/cli/release-notes/v2.50.2","title":"CodeBuddy Code v2.50.2 Release","body":"CodeBuddy Code v2.50.2 Release Improvements MCP Remote Transport Type: Added transport type support, allowing connection to MCP servers via remote HTTP, expanding MCP connectivity options Build Speed Improvement: Switched to the Rspack copy plugin and parallelized patch scripts to speed up project builds Task Progress Display Optimization: Completed subtasks are automatically cleared after all execution is finished, preventing accumulated completed entries from cluttering screen space and keeping the interface clean Bug Fixes Paste URL Misidentification Fix: Fixed an issue where pasting URLs starting with or were incorrectly identified as file paths"},{"id":"/cli/release-notes/v2.50.1","title":"CodeBuddy Code v2.50.1 Release","body":"CodeBuddy Code v2.50.1 Release Improvements Documentation Navigation Optimization: Moved the Agent Teams documentation to appear after Sub Agents, making the navigation structure better aligned with functional relevance and easier for users to browse in logical order Bug Fixes Config File Comment Preservation: Fixed an issue where JSONC comments under the mcpServers field were lost when saving MCP configuration, ensuring that comments added by users in configuration files are not accidentally deleted"},{"id":"/cli/release-notes/v2.50.0","title":"CodeBuddy Code v2.50.0 Release","body":"CodeBuddy Code v2.50.0 Release New Features Agent Teams Multi Agent Collaboration The new Team feature enables multiple Agents to work collaboratively, implementing task assignment and message passing through tools like TeamCreate, TeamDelete, and SendMessage. The Task tool extends support for teammate generation, and TaskList supports team task coordination, suitable for parallel processing scenarios in complex projects. Team functionality can be flexibly enabled or disabled via environment variables. Improvements Sub agent Task Display Optimization: Background tasks display real time progress in style, synchronous task progress is integrated into the loading spinner for a cleaner interface Task Completion Notification Enhancement: Notification messages include statistics such as execution duration, tool call count, and token usage for better understanding of task execution Background Task Resource Cleanup: Associated background shell tasks are automatically cleaned up when sub agents finish, preventing resource leaks TaskOutput Timeout Adjustment: Default timeout increased from 30s to 120s, defaults to blocking wait for completion, reducing timeout interruptions Lazy loaded Tool Fix: Fixed an issue where lazy loaded tools still reported \"Tool not found\" after being activated via search; now auto activates when not yet activated and prompts for retry Tool Search Results Optimization: Search results changed to concise text format, showing tool names and descriptions even when not expanded MCP Server Management Improvement: Fixed an issue where configuration was not actually deleted after removing an MCP server; SDK registered MCP servers now automatically connect during initialization and are immediately available SDK Parameter Format Standardization: CLI parameter formats for JS and Python SDKs standardized to style Plan Mode Interaction Optimization: Distinguishes between \"continue planning\" and \"exit plan mode\" operations when rejecting a plan, avoiding being tra"},{"id":"/cli/release-notes/v2.49.7","title":"CodeBuddy Code v2.49.7 Release","body":"CodeBuddy Code v2.49.7 Release New Features GLM 5.0 Model Support Added GLM 5.0 large language model with 200K context window and 48K output tokens, providing a more powerful reasoning capability option for domestic and iOA edition users."},{"id":"/cli/release-notes/v2.49.6","title":"CodeBuddy Code v2.49.6 Release","body":"CodeBuddy Code v2.49.6 Release Improvements SDK MCP Initialization Timing Optimization: Fixed a race condition between MCP server registration and prompt processing in SDK mode, ensuring MCP tools are ready before prompt processing to avoid tool call failures Headless Mode Detection Improvement: Optimized headless mode identification logic to support automatic detection for ACP mode and non TTY environments MCP Configuration File Path Support: The SDK's mcpServers parameter now supports file path string format, simplifying configuration ACP SDK Upgrade: Upgraded ACP SDK to version 0.14.1, fixing terminal output byte limit parameter type compatibility issues CI Configuration Optimization: Added npcName parameter support for bot configuration"},{"id":"/cli/release-notes/v2.49.5","title":"CodeBuddy Code v2.49.5 Release","body":"CodeBuddy Code v2.49.5 Release Improvements MCP Server Readiness Detection: Fixed an issue where MCP tools might not be ready during initialization in SDK mode, ensuring tools are fully initialized before the first invocation Build Optimization: Removed no longer needed build flags from Bun compilation, simplifying the binary packaging process Bug Fixes Session Compression Hang Fix: Fixed an issue where ACP sessions could permanently hang after compressing message logs; added timeout protection mechanism to prevent permanent blocking in abnormal conditions Session History Restoration: Fixed an issue where custom message items were not correctly skipped when finding the last message ID, avoiding incorrect message positioning when restoring sessions"},{"id":"/cli/release-notes/v2.49.3","title":"CodeBuddy Code v2.49.3 Release","body":"CodeBuddy Code v2.49.3 Release Improvements Model Error Prompt Enhancement: When a model is unavailable, automatically displays the list of models supported by the current account, making it easy for users to quickly switch to an available model Error Handling: Optimized the handling logic for wrapped ModelBehaviorError, ensuring that tool call failures are correctly identified and retried MCP Server Readiness Detection: Fixed an issue where MCP tools might not be ready during initialization in SDK mode"},{"id":"/cli/release-notes/v2.49.2","title":"CodeBuddy Code v2.49.2 Release","body":"CodeBuddy Code v2.49.2 Release Improvements Cross Session Task List Sharing Support sharing task lists across different sessions via the environment variable, facilitating multi terminal collaboration and continuous task tracking. Example: Date Format Enhancement Date display in system information now includes day of week information using a more user friendly format, improving readability. For example: . Bug Fixes Session Switch Permission Persistence Fixed an issue where the permission mode was not preserved when switching sessions, ensuring the current permission settings are maintained after switching. Previously, the permission mode would unexpectedly reset after switching sessions; now it is correctly retained. Interceptor Retry Mechanism Fixed an issue where the view layer still output the original failed result when the model response interceptor triggered an automatic retry. Now when the interceptor initiates a retry, it correctly suppresses the failed result output and only displays the successful response after retry. ACP Streaming Mode Interruption Optimization Interruption State Race Condition: Fixed a race condition in ACP streaming mode where the interruption state was modified by subsequent runs due to shared RunState; now uses event snapshot caching for interruption state Result Message Lookup: Improved final assistant message lookup logic to support reverse searching for completed messages from response output, with fallback to session history when not found Build Optimization Build Tool Upgrades: Upgraded goreleaser, bun, and uv to latest versions Bun Compilation Optimization: Enabled bytecode compilation and ESM format to improve startup performance"},{"id":"/cli/release-notes/v2.49.1","title":"CodeBuddy Code v2.49.1 Release","body":"CodeBuddy Code v2.49.1 Release Security Hardening Sandbox Configuration File Protection: Automatically prohibits writing to CodeBuddy configuration files (settings.json) in sandbox mode, preventing sandbox escape attacks through hook injection; file system denial rules are synchronously applied to Write, Edit, and other file operation tools to ensure comprehensive security policy consistency Improvements Session List Filtering: Filters out sub agent and compressed branch sessions, ensuring the session list and recent sessions only display actual user sessions SDK Documentation Fix: Fixed bracket formatting issues in authentication configuration links Bug Fixes Session History Navigation: Fixed an issue where switching sessions or restoring history could cause to incorrectly point to custom messages without IDs (such as summaries or topics), leading to conversation chain breakage"},{"id":"/cli/release-notes/v2.49.0","title":"CodeBuddy Code v2.49.0 Release","body":"CodeBuddy Code v2.49.0 Release New Features Usage Insights Report Added the command to generate AI driven usage insight analysis reports. Reports cover multiple dimensions including interaction style, project domain, friction points, highlights, and improvement suggestions, helping you better understand and optimize your AI collaboration patterns. Supports viewing HTML formatted visual reports in the browser. Improvements Statistics Accuracy: Optimized token usage statistics logic to correctly distinguish between main session and sub agent sessions; fixed token omission in tool calls Progress Display: Supports custom progress text, showing real time processing progress in loading state Custom Model Configuration: Fixed the issue where custom models incorrectly inherited global associated model configurations, ensuring behavior matches expectations Memory System: Optimized memory context prompts, streamlined wording, and added implicit memory source support to improve cross session memory recall Multi language Support Enhancement: All sub agents now correctly follow the user's language settings when responding UI Refresh Optimization: Optimized terminal refresh strategy after tool execution completion, added debounce mechanism to reduce unnecessary rendering Memory Optimization: Automatically releases session history and references after sub agent tasks complete, reducing memory usage Grep Search: Automatically corrects search pattern parameters to avoid unnecessary call failures; compatible with ripgrep regex syntax File Reading: Returns directory listing when reading a directory, helping quickly locate target files Bug Fixes Tool Error Handling: Improved error messages and handling logic when tools are not found Headless Mode: Fixed the issue where streaming output blocked when using non default agents, ensuring completion signals are correctly sent Tool Result Display: Fixed the issue where output from Edit and other tools was not displayed after execution, requir"},{"id":"/cli/release-notes/v2.48.1","title":"CodeBuddy Code v2.48.1 Release","body":"CodeBuddy Code v2.48.1 Release Improvements Environment Variable Authentication Conflict Detection: When or environment variables are set, the /login command automatically detects and suggests conflict resolution; authentication failures display more detailed diagnostic information to help quickly locate issues Sub agent Message Identification: Fixed the issue where sub agent user messages were missing parent tool identifiers during streaming output; clients can now correctly distinguish between main agent and sub agent messages MCP Prompt Command Format Unification: Unified the context concatenation format between MCP prompts and slash commands, ensuring the model correctly understands command sources and parameters Documentation Updates Prompt Hooks Documentation: Improved documentation for prompt based Hooks feature, added supported event descriptions, configuration examples, and best practice guides"},{"id":"/cli/release-notes/v2.48.0","title":"🚀 CodeBuddy Code v2.48.0 Release","body":"🚀 CodeBuddy Code v2.48.0 Release ✨ New Features Image to Image Tool (ImageEdit) New tool for AI based editing and modification of existing images: Supports style transformation, element addition, color modification, and other image editing operations Use command to switch to image to image model Configure the default model via environment variable or setting Prompt Hook New LLM based Hook type that supports defining trigger conditions using natural language for more flexible workflow control. 🔧 Improvements Image API Refactoring: Extracted shared module to unify API call logic for text to image and image to image Model Tag System: Introduced and model tags, allowing the same model to have multiple image generation capabilities Hook Configuration Panel: Support for displaying and managing Prompt Hooks with optimized blocking message display Token Calculation Accuracy: command now only counts actually enabled tools, excluding disabled built in tools and MCP tools Plan Mode Permission Inheritance: Plan mode now preserves permission settings from before entering, supporting combinations like \"plan + bypass\", with subagents also inheriting this permission configuration Hot Reload Optimization: Automatically detects and optimizes hot reload behavior in container environments with low FD limits, supports to completely disable hot reload Windows Path Hints: Added forward slash usage hints on Windows platform to avoid path parsing errors caused by backslashes WorkBuddy Configuration Separation: WorkBuddy now uses an independent configuration directory, separated from CLI's 🐛 Bug Fixes ACP Cancellation Handling: Optimized event delivery mechanism for cancel requests, ensuring sessions can correctly respond to cancellation operations MCP Non Interactive Mode: Fixed issue where MCP tools were not correctly identified as non interactive mode in ACP mode Memory Context Injection: Fixed missing system tags when injecting memory prompts Directory Scanning: Fixed incorrect relati"},{"id":"/cli/release-notes/v2.47.0","title":"🚀 CodeBuddy Code v2.47.0 Release","body":"🚀 CodeBuddy Code v2.47.0 Release ✨ New Features Cross session Memory New experimental memory feature that supports persistent memory across Agent sessions. You can enable this feature through the settings panel or the configuration. Team memory mode is also supported, storing memories in the project directory for team sharing. 🔧 Improvements command:// URI handling: Optimized command:// resource link handling in ACP protocol, correctly converting to slash command format and echoing original content blocks Command push filtering: Fixed issue where built in commands were incorrectly pushed to IDE, now only pushing user defined commands, skills, and specific built in commands File path search: Optimized matching precision for duplicate character queries to avoid mismatching scattered characters SSH remote clipboard: Fixed Ctrl+Y copy to clipboard failure in Linux + SSH remote environments by implementing OSC 52 protocol support for remote terminal clipboard operations Session resume history control: Optimized history replay logic when SDK resumes sessions, using signal to let CLI intelligently determine whether to replay history messages, improving the resume experience 🐛 Bug Fixes Pipe input: Fixed issue where content could not be read when using pipe input (e.g., ) Stop Hooks timing: Fixed issue where Stop Hooks were incorrectly executed when tools required user confirmation, now only triggered when there are no pending approval tools"},{"id":"/cli/release-notes/v2.46.0","title":"🚀 CodeBuddy Code v2.46.0 Release","body":"🚀 CodeBuddy Code v2.46.0 Release ✨ New Features Language Settings Added Language option in , allowing you to set your preferred response language. CodeBuddy Code will respond in your specified language, making communication more natural and smooth. 🔧 Improvements Copy Shortcut: Added Ctrl+Y shortcut to quickly copy the last AI response to clipboard, making it convenient to grab code snippets or important information Shell Command Execution Optimization: Optimized command execution mechanism to only use eval wrapper when additional environment configuration needs to be loaded, maintaining original behavior by default and improving command execution stability"},{"id":"/cli/release-notes/v2.45.1","title":"🚀 CodeBuddy Code v2.45.1 Release","body":"🚀 CodeBuddy Code v2.45.1 Release 🔧 Improvements Login UI Optimization: Adjusted login method order, moving iOA login to the last position with a note indicating it's only for Tencent internal employees, making it easier for new users to find the appropriate login method Documentation Enhancement: Added detailed explanations of four login methods in the quickstart documentation to help users understand the applicable scenarios for each login method SDK Version Update: Synchronized SDK JS to 0.3.40 and SDK Python to 0.3.38"},{"id":"/cli/release-notes/v2.45.0","title":"🚀 CodeBuddy Code v2.45.0 Release","body":"🚀 CodeBuddy Code v2.45.0 Release ✨ New Features Tool Search and Lazy Loading Added the ToolSearch tool, supporting natural language search for available tools. MCP servers now support configuration, deferring tool loading until needed, effectively reducing context consumption and improving tool selection accuracy. Environment Variable Model Configuration Support flexible model configuration through environment variables, convenient for use in CI/CD environments and scripts: : Override default agent model : Configure lite variant model : Configure reasoning variant model : Configure sub agent model : Enable extended thinking and set token budget SDK Commands Subscription SDK adds and methods, supporting retrieval and real time subscription to CLI available command list changes. 🔧 Improvements Skill Fork Context: Support configuration, allowing Skills to execute in an independent sub agent context Agent Type Specification: Added field to specify the sub agent type for executing Skills Image Paste Optimization: Added clipboard read retry mechanism, expanded macOS image format detection, supporting more screenshot tools Error Recovery Enhancement: When the model returns an invalid tool name, the system will prompt the model to check and retry Interface Simplification: Simplified \"Plan Mode\" to \"Plan\" for a cleaner interface 🐛 Bug Fixes ACP Multi turn Conversation: Fixed issue where second round prompts returned results directly, missing sessionUpdate events Plugin Loading Deduplication: Fixed issue where plugin skills, agents, and commands were duplicated in menus"},{"id":"/cli/release-notes/v2.44.1","title":"🚀 CodeBuddy Code v2.44.1 Release","body":"🚀 CodeBuddy Code v2.44.1 Release 🔧 Improvements Skill/Command Invocation Control: Added configuration option, allowing skills or commands to be set to manual trigger only mode, preventing automatic invocation by the model for more precise control over AI behavior Subagent Interruption Handling: Optimized behavior when Task subagents are interrupted by users, now returning clear interruption prompts and resumable Agent IDs, supporting task continuation via the parameter interruptions no longer mean lost progress Plan Subagent Enhancement: Plan subagents can now use Write, Edit, and MultiEdit tools to edit plan files, making plan mode more flexible and practical Media Content Error Auto Recovery: When requests fail due to oversized images, invalid formats, or too many images, the system automatically removes problematic content and provides compression suggestions, allowing conversations to continue WebFetch Tool Enhancement: Enhanced support for SPA pages, automatically extracting meta tag information when main page content is empty for better understanding of modern web applications Custom Headers Merge Optimization: Fixed case sensitivity issues when merging HTTP headers, now correctly overrides headers with the same name but different casing allowed tools Format Support: The field in custom Skills and Commands now supports both comma separated strings and YAML arrays for more flexible configuration Input Box Optimization: Fixed message sending timing issues, ensuring the input is cleared only after the message is fully sent 🐛 Bug Fixes Custom Request Header Parsing: Fixed newline character detection logic to ensure multi line header configurations are parsed correctly Documentation Links: Corrected sandbox documentation links to point to the correct files 📝 Documentation Updates SDK Example Documentation: Added SDK demo page with TypeScript SDK usage examples and best practices Skills and Commands Documentation: Updated documentation for skills and slash comma"},{"id":"/cli/release-notes/v2.44.0","title":"CodeBuddy Code v2.44.0 Release","body":"CodeBuddy Code v2.44.0 Release ✨ New Features Session Title Synchronization Support for synchronizing session topics through the ACP protocol to the IDE, enabling meaningful session names to be displayed in tabs or sidebars. When the AI assistant identifies a session topic, the IDE can automatically update the corresponding tab title, making it easier for users to identify and manage multiple parallel sessions. 🔧 Improvements SDK Version Update: Updated SDK JS to 0.3.37 and SDK Python to 0.3.35"},{"id":"/cli/release-notes/v2.43.1","title":"CodeBuddy Code v2.43.1 Release","body":"CodeBuddy Code v2.43.1 Release New Features Task Management Tool Refactoring The original single task management tool has been split into 5 independent tools, providing more granular task control capabilities: TaskCreate: Create new tasks TaskGet: Get task details TaskUpdate: Update task status TaskList: List all tasks TaskStop: Stop task execution Skill Tool Enhancement The Skill tool now supports direct execution of slash commands, with a new parameter for passing command arguments, making skill invocation more flexible. Improvements Plan Mode Enhancement: Added command for previewing current plan file content, optimized permission control in plan mode Shell Environment Snapshot: Automatically captures user shell configuration (functions, aliases, options) when executing commands, ensuring commands run in the user's familiar environment Shell Environment File Support: Added environment variable, supporting automatic loading of specified environment files before command execution Prompt Optimization: Optimized Agent prompt templates for improved response conciseness File Search Optimization: Streamlined hardcoded ignore rules, prioritizing project .gitignore configuration Grep Tool: Added parameter alias for improved usability Sub agent Configuration: Added parameter to control agent execution turns"},{"id":"/cli/release-notes/v2.43.0","title":"CodeBuddy Code v2.43.0 Release","body":"CodeBuddy Code v2.43.0 Release New Features Task Management Tool Refactoring The original single task management tool has been split into 5 independent tools, providing more granular task control capabilities: TaskCreate: Create new tasks TaskGet: Get task details TaskUpdate: Update task status TaskList: List all tasks TaskStop: Stop task execution Skill Tool Enhancement The Skill tool now supports direct execution of slash commands, with a new parameter for passing command arguments, making skill invocation more flexible. Improvements Plan Mode Enhancement: Added command for previewing current plan file content, optimized permission control in plan mode Shell Environment Snapshot: Automatically captures user shell configuration (functions, aliases, options) when executing commands, ensuring commands run in the user's familiar environment Shell Environment File Support: Added environment variable, supporting automatic loading of specified environment files before command execution Prompt Optimization: Optimized Agent prompt templates for improved response conciseness File Search Optimization: Streamlined hardcoded ignore rules, prioritizing project .gitignore configuration Grep Tool: Added parameter alias for improved usability Sub agent Configuration: Added parameter to control agent execution turns"},{"id":"/cli/release-notes/v2.42.3","title":"🚀 CodeBuddy Code v2.42.3 Release","body":"🚀 CodeBuddy Code v2.42.3 Release 🔧 Improvements Session Summary and Topic Persistence AI Summary Generation: Automatically generates AI summaries for sessions, displaying friendlier descriptions in the list to help you quickly identify and restore historical sessions Topic Persistence: Terminal titles are now saved to session history for easier viewing and management Non Interactive Mode Support: Added parameter to enable session tracking in non interactive mode Fine Grained Session Tracking Configuration Split session tracking functionality into two independent environment variables for more flexible configuration: : Controls whether to generate session summaries : Controls whether to save session topics This allows you to enable or disable specific features independently based on your actual needs."},{"id":"/cli/release-notes/v2.42.1","title":"🚀 CodeBuddy Code v2.42.1 Release","body":"🚀 CodeBuddy Code v2.42.1 Release 🔧 Improvements Startup Performance Monitoring: Added startup time analyzer, viewable in the panel to see timing for each phase, helping diagnose slow startup issues WSL Environment Support: Automatically detects WSL environment and prompts the model to use correct Linux path format, improving WSL user experience Path Compatibility: Fixed parsing issues when models send Windows style paths on non Windows platforms, avoiding path errors SDK Version Update: Synchronized SDK JS to 0.3.32, SDK Python to 0.3.30"},{"id":"/cli/release-notes/v2.42.0","title":"🚀 CodeBuddy Code v2.42.0 Release","body":"🚀 CodeBuddy Code v2.42.0 Release ✨ New Features MCP Configuration Now Supports JSONC Format MCP configuration files now support JSONC (JSON with Comments) format, making configuration files easier to maintain: Support for single line comments ( ) Support for multi line comments ( ) Support for trailing commas 🔧 Improvements Python 3.10 Support: Agent SDK extended compatible Python version range, now supporting Python 3.10 ACP Session Control: Fixed setting model and permission mode via SDK Tool Call Stability: Automatically detects incomplete tool call parameters returned by the model and requests regeneration, improving conversation stability Session Fork Enhancement: Supports more parameter combinations, allowing source session specification via or Command Message Format: Unified message tag format for slash commands and skills, added tag support for argument extraction Data Tracking Accuracy: Fixed issue where prompt suggestion data was mixed with main conversation data 🐛 Bug Fixes Hook Output Display: Fixed issue where extra JSON raw data was displayed after hook execution Symlink Support: Fixed issue where symlink files in the rules directory couldn't be loaded correctly, added circular reference protection"},{"id":"/cli/release-notes/v2.41.8","title":"🚀 CodeBuddy Code v2.41.8 Release","body":"🚀 CodeBuddy Code v2.41.8 Release 🔧 Improvements Print Mode Output Optimization: Silent notification messages in print mode to avoid polluting agent output stream, making script integration cleaner Configuration Structure Simplification: Removed redundant deploymentType configuration field, simplifying product configuration structure 🐛 Bug Fixes Custom Request Header Parsing: Fixed newline character judgment logic to ensure multi line header configurations are parsed correctly SDK System Prompt Passing: Fixed the issue where parameter was not correctly passed in v2 Session API SDK Session Loading Race Condition: Fixed race condition when calling and concurrently in multi window scenarios, preventing session data inconsistency 📝 Documentation Updates Environment Variable Documentation: Added feature switch documentation for controlling image generation functionality Release Notes: Added Chinese and English release notes for v2.40.0 through v2.41.7 SDK Documentation: Enhanced documentation for hooks, permissions, TypeScript SDK, etc."},{"id":"/cli/release-notes/v2.41.7","title":"CodeBuddy Code v2.41.7 Release","body":"CodeBuddy Code v2.41.7 Release Improvements Checkpoint Performance Optimization: Changed checkpoint file reading to asynchronous parallel processing to avoid blocking the event loop and improve response performance Session Restore Optimization: Improved session/load flow to ensure history messages and artifact restoration execute after response is sent, fixing duplicate sending issues in multi connection scenarios SDK Tool Parameter Passing: Fixed allowedTools/disallowedTools parameter format to ensure correct passing of multiple tool names Python SDK Stream Buffer: Added 100MB buffer limit to prevent errors when MCP services return large JSON responses SDK Version Tracking: SDK automatically injects User Agent header when communicating with CLI, including SDK version and runtime information for backend service tracking and diagnostics SDK Version Updates: Updated SDK JS to 0.3.29 and SDK Python to 0.3.27 Documentation Updates SDK Custom Tools Documentation: Fixed incorrect usage of tool decorator in Python SDK examples, changed to import directly from the package and use correct decorator syntax"},{"id":"/cli/release-notes/v2.41.6","title":"🚀 CodeBuddy Code v2.41.6 Release","body":"🚀 CodeBuddy Code v2.41.6 Release 🔧 Improvements Input Submission Optimization: Fixed an issue where pressing Enter could not submit when typing slash commands. Now commands can be submitted normally, or invalid commands are sent as regular messages Hot Reload Optimization: Fixed an issue where plugins directory hot reload could trigger change events for system directories like , improving stability Context Compression: Optimized history processing logic to filter branch history ensuring compression accuracy Tool Description Template: Optimized quote formatting in tool descriptions for improved readability SDK Version Update: Updated SDK JS to 0.3.28, SDK Python to 0.3.26"},{"id":"/cli/release-notes/v2.41.5","title":"🚀 CodeBuddy Code v2.41.5 Release","body":"🚀 CodeBuddy Code v2.41.5 Release 🐛 Bug Fixes Hot Reload Stability Improvement: Fixed an issue where plugins directory hot reload could trigger change events for system directories like , ensuring more stable and reliable hot reload functionality 🔧 Improvements Session Lock Mechanism Optimization: Delayed session lock acquisition to actual usage time, reducing lock leak risk, while supporting fork operations without acquiring locks, improving session management flexibility SDK Sync Update: Updated SDK JS to 0.3.27, SDK Python to 0.3.25"},{"id":"/cli/release-notes/v2.41.4","title":"🚀 CodeBuddy Code v2.41.4 Release","body":"🚀 CodeBuddy Code v2.41.4 Release 🔧 Improvements SDK Version Sync: Updated SDK JS to 0.3.26, SDK Python to 0.3.24, keeping SDK and CLI versions in sync"},{"id":"/cli/release-notes/v2.41.3","title":"🚀 CodeBuddy Code v2.41.3 Release","body":"🚀 CodeBuddy Code v2.41.3 Release 🔧 Improvements New Kimi K2.5 Model: Added support for Kimi K2.5 model with tool calling, image understanding, and reasoning capabilities, providing users with more model choices Parameter Validation Optimization: Improved tool parameter validation error messages with clearer error information to help quickly locate issues Automatic Type Conversion: Support automatic conversion of string form numeric parameters, improving compatibility with different models Hot Reload Notification Optimization: User level settings.json hot reload no longer displays notifications, reducing unnecessary interruptions"},{"id":"/cli/release-notes/v2.41.2","title":"🚀 CodeBuddy Code v2.41.2 Release","body":"🚀 CodeBuddy Code v2.41.2 Release 🔧 Improvements SDK Version Update: Updated SDK JS to 0.3.24, SDK Python to 0.3.22"},{"id":"/cli/release-notes/v2.41.1","title":"🚀 CodeBuddy Code v2.41.1 Release","body":"🚀 CodeBuddy Code v2.41.1 Release 🔧 Improvements Session Management Optimization: SDK refactored sessionId parameter to be auto generated, simplifying API call flow so developers no longer need to manually manage sessionId SDK Version Update: Updated SDK JS to 0.3.23, SDK Python to 0.3.21"},{"id":"/cli/release-notes/v2.41.0","title":"🚀 CodeBuddy Code v2.41.0 Release","body":"🚀 CodeBuddy Code v2.41.0 Release ✨ New Features Hot Configuration Reload Now when you modify Skills, memory files (CODEBUDDY.md), configuration files, etc., changes take effect automatically without restarting the CLI. Say goodbye to frequent restarts and enjoy a smoother workflow. 🔧 Improvements Tool Whitelist: Added option to limit the set of built in tools CodeBuddy can use. You can set it to an empty string to disable all built in tools, or specify a comma separated list of tools for more controlled tool usage 📝 Documentation Updates Environment Configuration Guide: Added environment variable configuration guidance to SDK, ACP, and IAM documentation, helping users of different versions configure authentication environment correctly"},{"id":"/cli/release-notes/v2.40.1","title":"CodeBuddy Code v2.40.1 Release","body":"CodeBuddy Code v2.40.1 Release Bug Fixes Image Generation Tool: Fixed output directory path parsing error on Windows systems, images are now correctly generated to the specified directory Input Suggestions: Fixed issue where selecting from suggestion menu caused duplicate message sending, improving interaction experience"},{"id":"/cli/release-notes/v2.40.0","title":"CodeBuddy Code v2.40.0 Release","body":"CodeBuddy Code v2.40.0 Release New Features SDK Delayed Control Request Synchronization The SDK now supports delayed control request synchronization, allowing you to flexibly set permission modes and model options before sending messages. This improvement provides SDK users with a more flexible API calling approach, making it convenient to adjust configurations before message submission. Usage Example: Improvements SDK Version Sync: SDK JS updated to 0.3.20, SDK Python updated to 0.3.18, both now support the new delayed control request feature"},{"id":"/cli/release-notes/v2.39.0","title":"CodeBuddy Code v2.39.0 Release","body":"CodeBuddy Code v2.39.0 Release New Features Image Generation Tool Added the tool, enabling the AI assistant to generate images directly from text descriptions. Supports customizable size, style, quality, and other parameters, providing more possibilities for creative workflows. Text to Image Model Switching: Use the command to view and switch available text to image models CLI Parameter Support: Use the parameter at startup to specify the default model Configuration Persistence: Set in user configuration as the default text to image model Improvements Configuration Panel Optimization: Moved the Env Route option to developer mode, activated via or , simplifying the regular configuration interface Input Submission Fix: Fixed the issue where pressing Enter to submit while typing slash commands didn't work; commands can now be submitted normally, or invalid commands sent as regular messages Tool Description Optimization: Improved quote formatting in tool descriptions for better readability SDK Version Update: Updated SDK JS to 0.3.19 and SDK Python to 0.3.17"},{"id":"/cli/release-notes/v2.38.2","title":"CodeBuddy Code v2.38.2 Release","body":"CodeBuddy Code v2.38.2 Release Improvements Path Resolution Optimization: Unified path resolution logic for WASM files and certificate files using PathUtils, supporting loading embedded resources from EMBEDFS, improving compatibility across different deployment environments Bug Fixes Console Output: Fixed an issue where console output mode parsing failed in certain scenarios"},{"id":"/cli/release-notes/v2.38.1","title":"CodeBuddy Code v2.38.1 Release","body":"CodeBuddy Code v2.38.1 Release Improvements Command Safety Check Simplification: Removed unused command blacklist functionality, streamlined code structure, and improved code maintainability SDK Version Sync: Updated SDK JS to 0.3.17 and SDK Python to 0.3.15"},{"id":"/cli/release-notes/v2.38.0","title":"CodeBuddy Code v2.38.0 Release","body":"CodeBuddy Code v2.38.0 Release New Features Sub Agent Model Variants The Task tool now supports a parameter for specifying model variants like and . You can choose the appropriate model based on task complexity: : Suitable for lightweight tasks such as simple searches and quick file operations : Suitable for complex analysis, architectural decisions, and multi step problem solving Improvements Checkpoint Hook Statistics Optimization: Optimized file change statistics calculation by comparing backup files with current files to provide accurate line addition and deletion counts Shell Encoding Handling: Optimized character encoding/decoding logic for terminal output, improving display of Chinese and other non ASCII characters on Windows SDK Version Update: Updated SDK JS to 0.3.16 and SDK Python to 0.3.14 Documentation Updates Environment Requirements: Clarified that the minimum Node.js version is 18.20+ Development Documentation: Enhanced CODEBUDDY.md with development commands, directory structure descriptions, and build process details Documentation Sync: Synchronized CLI documentation to the IDE docs directory, added cost documentation, etc."},{"id":"/cli/release-notes/v2.37.20","title":"CodeBuddy Code v2.37.20 Release","body":"CodeBuddy Code v2.37.20 Release Improvements Model Temporary Switch: Press key in model selection panel to apply only to current session without modifying user configuration, convenient for temporarily testing different models model Parameter Optimization: Command line parameter now correctly overrides project level configuration, taking effect immediately in current session Context Compression Optimization: Filter rules and memory content during compression to avoid compressing configuration instructions into summary, automatically re inject complete rules after compression to maintain AI behavior consistency Configuration Panel Simplification: Hide developer options, accessible via , making configuration interface cleaner"},{"id":"/cli/release-notes/v2.37.19","title":"CodeBuddy Code v2.37.19 Release","body":"CodeBuddy Code v2.37.19 Release Improvements SDK Version Sync: Updated JavaScript/TypeScript SDK to 0.3.14, Python SDK to 0.3.12, keeping SDK in sync with CLI version for optimal compatibility"},{"id":"/cli/release-notes/v2.37.18","title":"CodeBuddy Code v2.37.18 Release","body":"CodeBuddy Code v2.37.18 Release Bug Fixes Login Flow Optimization: Fixed login method mapping configuration issue, improving login interface interaction experience and usability Improvements SDK Version Update: Sync updated SDK JS to 0.3.13, SDK Python to 0.3.11, maintaining compatibility with latest SDK"},{"id":"/cli/release-notes/v2.37.17","title":"CodeBuddy Code v2.37.17 Release","body":"CodeBuddy Code v2.37.17 Release Improvements SDK Version Sync Update: SDK JS updated to 0.3.12, SDK Python updated to 0.3.10, ensuring sync with CLI version"},{"id":"/cli/release-notes/v2.37.16","title":"CodeBuddy Code v2.37.16 Release","body":"CodeBuddy Code v2.37.16 Release Improvements Configuration Update: Included robot configuration file in build process to ensure configuration sync update Bug Fixes Enterprise Edition Login Compatibility: Fixed issue where model list was inconsistent when users switched to enterprise edition URL login, ensuring configuration loads correctly after endpoint change"},{"id":"/cli/release-notes/v2.37.15","title":"CodeBuddy Code v2.37.15 Release","body":"CodeBuddy Code v2.37.15 Release Bug Fixes Logout Flow Optimization Fixed issue where token was not properly cleared after logout, ensuring authentication interceptor correctly handles logout state, avoiding subsequent requests using expired credentials. HTTP Interceptor Enhancement Improved error handling and state synchronization mechanism of authentication HTTP interceptor, improving stability and reliability of authentication flow."},{"id":"/cli/release-notes/v2.37.14","title":"CodeBuddy Code v2.37.14 Release","body":"CodeBuddy Code v2.37.14 Release New Features SDK Dynamic Configuration API Added and methods, allowing developers to dynamically retrieve currently available permission modes and model lists. Additionally, and now only affect the current session and no longer persist to configuration files, making configuration management more flexible in multi session scenarios. Model Switch Shortcut Support Option/Alt + P to quickly switch models without entering settings. Improvements User Hints Enhancement: Added more built in hints to help users learn shortcuts and operation tips Output Limit Unification: Unified token limit for all tools to 20000, image content is not subject to this limit; Read tool supports environment variable for customization Startup Performance Optimization: Optimized authentication and service configuration initialization flow, improving CLI cold start speed Plugin Marketplace Installation: Optimized marketplace and plugin installation flow, significantly reducing wait time for first installation and auto updates Async File Operations: Changed custom commands, Agent, and Skill loading to async parallel processing Git Info Collection: Optimized repository scanning logic with async parallel processing for improved performance Bug Fixes Diff Rendering Stability: Fixed rendering crash caused by empty strings or incomplete JSON during tool call parameter parsing"},{"id":"/cli/release-notes/v2.37.13","title":"CodeBuddy Code v2.37.13 Release","body":"CodeBuddy Code v2.37.13 Release Improvements Enterprise Edition Authentication Optimization Optimized enterprise ID acquisition timing to ensure enterprise model list loads correctly after user login, improving enterprise user experience. Custom Authentication Fix Fixed issue where token was lost during authentication state changes in custom authentication environments, ensuring stability and reliability of authentication flow."},{"id":"/cli/release-notes/v2.37.12","title":"CodeBuddy Code v2.37.12 Release","body":"CodeBuddy Code v2.37.12 Release UI Optimization App Icon Update: Updated Work app icon for improved visual consistency Improvements Activity Bar Enhancement: Added activity bar component, supporting richer navigation and interaction features Settings Service Optimization: Refactored settings service for more flexible configuration management History Cache: Added history cache service, improving session history loading and management experience Process Pool Management: Introduced ACP process pool, improving resource utilization efficiency in multi session scenarios Mermaid Diagrams: Enhanced Mermaid diagram rendering, supporting more chart types and interactions Internationalization Completion: Added Chinese and English interface text"},{"id":"/cli/release-notes/v2.37.11","title":"CodeBuddy Code v2.37.11 Release","body":"CodeBuddy Code v2.37.11 Release Maintenance Update This is a maintenance release, mainly including: SDK version sync update Internal dependency optimization"},{"id":"/cli/release-notes/v2.37.10","title":"CodeBuddy Code v2.37.10 Release","body":"CodeBuddy Code v2.37.10 Release Improvements Login Method Optimization: Simplified login options to \"Chinese Site\", \"International Site\" and \"Enterprise Domain\", domestic site login will automatically select the best authentication method based on network environment, improving login experience"},{"id":"/cli/release-notes/v2.37.9","title":"CodeBuddy Code v2.37.9 Release","body":"CodeBuddy Code v2.37.9 Release Improvements Sidebar Interaction Optimization: Support drag to adjust width, added session management action buttons, making interface operations more flexible and convenient User Agent Identification: ACP process automatically sets User Agent request header containing version info on startup, facilitating server side client version identification Configuration Sync Optimization: Added throttle + debounce mechanism for product configuration sync, reducing performance overhead from high frequency calls Log Enhancement: Added debug logs for streaming message processing and configuration cache expiration, facilitating issue troubleshooting"},{"id":"/cli/release-notes/v2.37.8","title":"CodeBuddy Code v2.37.8 Release","body":"CodeBuddy Code v2.37.8 Release Improvements Session State Management Optimization: Optimized lastMessageId update mechanism during async compaction, ensuring correct message ID association in long conversation scenarios, improving session recovery reliability"},{"id":"/cli/release-notes/v2.37.7","title":"CodeBuddy Code v2.37.7 Release","body":"CodeBuddy Code v2.37.7 Release New Features Red Packet Cover Promotion: Help panel adds \"Code to Success\" red packet cover claim entry, automatically displays corresponding link based on domestic/international version, helping you claim exclusive red packet covers during the New Year"},{"id":"/cli/release-notes/v2.37.6","title":"CodeBuddy Code v2.37.6 Release","body":"CodeBuddy Code v2.37.6 Release Improvements Session Recovery Enhancement: Support displaying sessions generated by command, users no longer lose session history after compaction"},{"id":"/cli/release-notes/v2.37.5","title":"CodeBuddy Code v2.37.5 Release","body":"CodeBuddy Code v2.37.5 Release Bug Fixes ACP Session Model Setting: Fixed issue where subsequent conversations still used the old model after switching models via SDK, model switching now takes effect immediately"},{"id":"/cli/release-notes/v2.37.4","title":"CodeBuddy Code v2.37.4 Release","body":"CodeBuddy Code v2.37.4 Release New Features Custom Session ID SDK now supports specifying custom session IDs when creating sessions, making it easier for external systems to track and manage sessions. This is useful for scenarios that require integrating CodeBuddy sessions with business systems. Bug Fixes Session History Loading: Fixed issue where historical messages couldn't display correctly after session reconnection, now using ACP session/load mechanism to load history Model Selection Sync: Fixed model ID mapping issue, properly handling the modelId field returned by SDK Model Persistence: Optimized model selection persistence logic to ensure user selections remain consistent after session reconnection Session Subscription Stack Overflow: Prevented recursive stack overflow caused by repeated session subscriptions Stop Hook Serialization: Removed unused result field to avoid errors caused by serialization circular references Improvements Tool Steps Display: Optimized tool call list layout and animation effects for better visual experience"},{"id":"/cli/release-notes/v2.37.3","title":"🚀 CodeBuddy Code v2.37.3 Release","body":"🚀 CodeBuddy Code v2.37.3 Release 🔧 Improvements Electron Desktop Application Experience Optimization Single Instance Lock: Prevents multiple application instances; the second instance will automatically focus the existing window macOS Window Behavior: Closing the window now hides rather than quits the application, conforming to macOS application standards Dock Icon Cleanup: Fixed issue where child processes displayed extra icons in the macOS Dock SDK API Enhancement Dynamic Permission Mode Switching: Session API added and methods, supporting dynamic permission mode switching within sessions Plan Mode Optimization: Switching to plan mode now returns the plan file path, making it easier for SDK to retrieve and display History Message Handling: Optimized history message processing flow in resume + prompt scenarios for Query API Message List Interaction Optimization Timeline Sorting: Optimized timeline sorting for messages and tool calls, supporting grouped display of tool calls Feedback Feature: Added message like and dislike buttons, supporting user feedback Image Preview: User message images now support click to enlarge preview with smooth animation effects Copy Feature: Improved assistant message copy logic, supporting copying complete reply groups; user messages support double click to copy"},{"id":"/cli/release-notes/v2.37.2","title":"🚀 CodeBuddy Code v2.37.2 Release","body":"🚀 CodeBuddy Code v2.37.2 Release 🔧 Improvements ACP Authentication Enhancement User information is now returned in the authenticate response, allowing clients to get the current logged in user's ID, username, and nickname Fixed issue where calling the authentication API again for already logged in users would not display the login page Asynchronous Context Compression Introduced asynchronous context compression mechanism that automatically triggers background compression when conversation history reaches a critical threshold, improving response performance in long conversation scenarios. SDK Connection Performance Optimization Optimized connection pool mechanism with prewarmed connection reuse for concurrent query scenarios, significantly reducing first message latency Added option to move CLI startup time to the prewarm phase Added session lock mechanism to prevent data confusion caused by concurrent restoration of the same session ID Other Improvements ACP Session Model Isolation: Fixed issue where switching models affected global configuration; model switching now only affects the current session Plugin Uninstall Cleanup: Fixed issue where MCP configuration remained after uninstalling plugins; related configuration is now automatically cleaned up during uninstallation Network Error Handling: Optimized automatic retry logic for network errors in print mode to avoid abnormal exits SDK Performance Optimization: Optimized session restoration and user interaction flow, improving SDK response speed and stability Session Storage: Support cross project directory session search, added meta file separated storage Authentication Flow: Optimized authentication mechanism, added user information query interface Service Mode: Enhanced server mode policy functionality"},{"id":"/cli/release-notes/v2.37.1","title":"🚀 CodeBuddy Code v2.37.1 Release","body":"🚀 CodeBuddy Code v2.37.1 Release 🔧 Improvements Authentication API Enhancement Added API to support clearing cached authentication tokens, allowing you to easily switch users or environments. Additionally, now automatically detects existing valid authentication, avoiding redundant logins and improving user experience. Checkpoint Hook Added experimental Hook that triggers automatically after file modifications. This Hook provides file snapshots and change statistics, facilitating file change history tracking and automated auditing, offering more powerful support for code quality management. Session API Hooks Support V2 Session API now supports configuring Hooks, enabling interception and control of tool execution within sessions. This allows you to customize session behavior more flexibly and achieve finer grained execution control."},{"id":"/cli/release-notes/v2.37.0","title":"🚀 CodeBuddy Code v2.37.0 Release","body":"🚀 CodeBuddy Code v2.37.0 Release ✨ New Features SDK Authentication API Added experimental authentication interface to support SDK independent login flow: Supports multiple authentication environments (external, internal, iOA, cloudhosted, selfhosted) Automatically detects login status to avoid duplicate login Notifies login URL via callback, supports custom browser opening logic 🔧 Improvements and Optimizations React State Management: Refactored message status update logic to use immutable operations instead of direct modification, following React best practices and improving component rendering stability"},{"id":"/cli/release-notes/v2.36.3","title":"🚀 CodeBuddy Code v2.36.3 Release","body":"🚀 CodeBuddy Code v2.36.3 Release 🔧 Improvements & Optimizations Enhanced Cross Platform Compatibility: Improved path handling for Shell execution on Windows systems, fixing execution issues caused by paths containing spaces Enhanced Permission Matching: Improved permission rule matching for complex Shell commands, supporting command parsing with operators such as , , , , enabling permission rules to accurately match individual sub commands within combined commands Input Menu Response Optimization: Fixed keyboard shortcut conflicts caused by menu status detection delays, improving response speed for command and file suggestion menus History Record Filtering: Optimized message display when loading session history 🐛 Bug Fixes Circular Dependency Fix: Resolved circular reference issues between modules, improving service isolation through deferred dependency retrieval 📝 Documentation Updates SDK Documentation Correction: Corrected custom tool import paths; and should be imported directly from SDK Version Requirement Update: Updated CodeBuddy Agent SDK version requirement in documentation from v0.2.0 to v0.1.24"},{"id":"/cli/release-notes/v2.36.2","title":"🚀 CodeBuddy Code v2.36.2 Release","body":"🚀 CodeBuddy Code v2.36.2 Release 🔧 Improvements Team Task Management Added team task management slash commands, supporting task entry, viewing, starting, and completion workflows, helping teams collaborate more efficiently and track task progress. Also optimized the task ID format, adopting a date + random hex format to avoid ID conflicts during parallel multi branch development. Flowchart Generation Added the slash command, supporting the generation of sketch style drawio flowcharts, making it easy to quickly create and visualize workflows. Tool Return Result Rendering: Improved standardized handling of tool call results and error interruption display, optimized text display and line break logic in the StreamToolCall component Authentication Source Display: Displays the current authentication method being used (environment variables, apiKeyHelper script, or logged in account) in the status panel, making it easy to understand the current authentication status Documentation Link Website Update: Documentation links in CLI help information updated to official website addresses, with www.codebuddy.ai for the international version and copilot.tencent.com for the domestic version Model Compatibility Optimization: Improved compatibility for models that do not support images when using file reading tools, avoiding errors caused by image content Bashes Panel: Optimized layout and style display, improving interaction experience 🐛 Bug Fixes Input History: Fixed the issue where pressing the down arrow after browsing history with the up arrow could not restore the input draft Input History: Fixed the issue where only the last entry was retained in history after entering multiple consecutive items"},{"id":"/cli/release-notes/v2.36.1","title":"🚀 CodeBuddy Code v2.36.1 Release","body":"🚀 CodeBuddy Code v2.36.1 Release 🔧 Improvements Windows Platform Performance Optimization: Optimized machine ID retrieval and Bash path lookup logic on the Windows platform, significantly improving startup speed and response performance, delivering a smoother experience for Windows users"},{"id":"/cli/release-notes/v2.36.0","title":"🚀 CodeBuddy Code v2.36.0 Release","body":"🚀 CodeBuddy Code v2.36.0 Release 🔧 Improvements Enhanced SDK Error Handling Enhanced error handling capabilities in JavaScript and Python SDKs to provide developers with clearer error messages and more reliable exception catching mechanisms. Session Recovery Feature Improvements Optimized handling of edge cases in session recovery functionality, improving recovery stability and accuracy in various exceptional scenarios. Example Code Additions Added example code for authentication error handling and session management to help developers better understand and use SDK features. Type Definition Optimization Optimized SDK type definitions to provide better type safety support, reduce type errors, and improve development experience. SDK MCP Feature Optimization Optimized the Python SDK's MCP functionality and query interface implementation, improving the stability and usability of MCP integration."},{"id":"/cli/release-notes/v2.35.0","title":"🚀 CodeBuddy Code v2.35.0 Release","body":"🚀 CodeBuddy Code v2.35.0 Release ✨ New Features Structured Output Support specifying JSON Schema through the command line parameter to make Agent output conform to predefined data structures. This feature is particularly useful for scenarios that require programmatic processing of Agent output, such as automated workflows and data pipeline integration. 🔧 Improvements Enhanced Concurrency Safety: Added cross process file locking mechanism to provide reliable concurrency protection for settings and update operations, avoiding data conflicts when multiple instances are running Hook System Refactoring: Unified the scheduling and execution of internal hooks and external shell hooks, improving extensibility and consistency MCP Server Management: Refactored disabled state management to support configuration persistence across different scopes, making configuration more flexible Context Compression Optimization: Fixed logic issues with message queue processing and tool approval interruption after compression Terminal Experience Enhancement: Optimized terminal title update timing for faster response Model Configuration Update: Added support for GPT 5.2 Codex model and adjusted model naming conventions 🐛 Bug Fixes Markdown Table Rendering: Fixed issues where links, code snippets, and other content within table cells could not be formatted correctly Configuration Concurrency Issues: Improved concurrent safety of configuration file read/write operations SDK Dependency Fix: Fixed compilation errors caused by missing MCP SDK dependencies in agent sdk js"},{"id":"/cli/release-notes/v2.34.1","title":"CodeBuddy Code v2.34.1 Release","body":"CodeBuddy Code v2.34.1 Release 🔧 Improvements Memory Loading Logs: Enhanced log output when loading Memory rules, displaying detailed loading information for easier debugging Shell Detection: Optimized shell type detection logic, supporting override of default shell through the environment variable PTY Compatibility: Improved PTY loading logic on Linux systems, automatically detecting GLIBC version and musl systems to avoid loading failures on incompatible environments"},{"id":"/cli/release-notes/v2.34.0","title":"🚀 CodeBuddy Code v2.34.0 Release","body":"🚀 CodeBuddy Code v2.34.0 Release ✨ New Features SDK MCP Server Support Added SDK MCP Server type, allowing registration and management of MCP servers through the SDK's internal messaging mechanism, providing SDK developers with more flexible tool extension capabilities. 🔧 Improvements MCP Connection Stability: When MCP servers fail to respond normally, the current session is no longer interrupted. Instead, error information is logged and operation continues, improving the user experience Context Compression Fix: Fixed errors caused by session state processing exceptions during context compression Configuration Save Optimization: Use deep comparison to determine default values, avoiding misidentification of object/array type configuration items Plan Mode Interaction Experience: Optimized the Plan Mode tool confirmation interface display, enhancing user interaction experience when using plan mode Command Display Optimization: Improved command display in the Bash tool permission confirmation interface, supporting multi line text wrapping display Session Recovery Enhancement: SDK automatically returns historical messages when recovering sessions, supporting viewing of previous conversation history Subdirectory Rules Loading: Support lazy loading of CODEBUDDY.md rule files in subdirectories, using LRU cache to improve performance 🐛 Bug Fixes Suggestion Fix: Fixed errors caused by missing tool call results in exceptional situations 📝 Documentation Updates SDK MCP Integration Guide: Detailed introduction on how to integrate and use MCP servers in CodeBuddy Agent SDK SDK Custom Tools Guide: Demonstrates how to create and use custom tools directly integrated in the SDK Authentication Documentation: Added environment variable configuration instructions for China version, Overseas version, and iOA version"},{"id":"/cli/release-notes/v2.33.1","title":"CodeBuddy Code v2.33.1 Release","body":"CodeBuddy Code v2.33.1 Release Improvements & Optimizations Session Context Type Optimization: Refactored type definitions for sessions, checkpoints, and context management, enhancing type safety for input item handling and history tools Command Permission Check: Optimized permission evaluation for whitelisted command chains, directly allowing execution when all subcommands are in the safe whitelist without additional confirmation Memory Loader: Fixed compilation warnings caused by temporarily disabled subdirectory Memory loading methods"},{"id":"/cli/release-notes/v2.33.0","title":"CodeBuddy Code v2.33.0 Release","body":"CodeBuddy Code v2.33.0 Release New Features Model Selection Memory When opening the model panel, it now automatically scrolls to the currently active model, eliminating the need to manually search for it. Improvements & Optimizations LSP Position Conversion: Fixed coordinate conversion logic between editor line/column numbers and LSP server, enabling accurate positioning for code navigation and reference lookup operations Message Queue Stability: Fixed an issue where messages sent by users during Agent execution could be lost, ensuring messages are correctly preserved in multi turn conversations Input Suggestions Optimization: Added debounce mechanism to reduce unnecessary requests and improve input experience Performance Optimization: Reduced unnecessary component re renders to improve interface responsiveness Stability Improvement: Fixed potential crash issues in empty list scenarios Subdirectory Rules Support: Support for placing CODEBUDDY.md files in project subdirectories, with rules automatically triggered when operating on files in that directory File Extension Compatibility: Added support for extension (CODEBUDDY.mdc, AGENTS.mdc) Glob Matching Optimization: Enabled matchBase mode, allowing simple patterns like to match files at any directory level Conditional Rule Injection Enhancement: Automatic conditional rule matching triggered during file operation tool execution Bug Fixes Context Compression: Fixed an issue where interrupting a session during compression incorrectly displayed an interruption message Documentation Updates Tool Documentation: Added documentation for NotebookEdit, LSP, and TaskOutput tools CLI Parameters: Added documentation for and parameters"},{"id":"/cli/release-notes/v2.32.0","title":"🚀 CodeBuddy Code v2.32.0 Release","body":"🚀 CodeBuddy Code v2.32.0 Release ✨ New Features Prompt Suggestions After the Agent completes a conversation, CodeBuddy automatically predicts your next possible action and displays it as gray text in the input area. Press Enter to send the suggestion directly, or press Tab to enter edit mode, making your workflow smoother. 🔧 Improvements & Optimizations Context Management: Fixed exception handling logic during MCP tool information collection, improving system stability Configuration System: Optimized default value merging logic, fixed loading issues across different configuration layers Background Task Management: Optimized task registration mechanism, supporting selective state monitoring, reducing resource overhead File Search Tool: Enhanced file path matching algorithm and Git ignore rule processing, improving search accuracy Error Handling: Improved network error logging, enhancing problem troubleshooting capabilities 📝 Documentation Updates MCP Configuration Documentation: Updated MCP configuration file location description, added priority based configuration file parsing mechanism"},{"id":"/cli/release-notes/v2.31.2","title":"🚀 CodeBuddy Code v2.31.2 Release","body":"🚀 CodeBuddy Code v2.31.2 Release 🔧 Improvements & Optimizations Session History Enhancement: Each history message now automatically records the working directory at the time of creation, facilitating message source tracking Idle Prompt Notification: Automatically sends terminal notification to remind users when there's no operation 60 seconds after user input, preventing forgotten ongoing tasks MCP Configuration Path Consistency: Fixed path priority logic in toggle manager when reading/writing configurations, ensuring consistency with config store behavior OSC Notification Protocol Optimization: Adjusted terminal protocol priority, providing dedicated OSC 9 support for iTerm, improving compatibility experience Notification Message Simplification: Removed product name prefix from notification messages, making messages more concise and clear Plan Mode Optimization: Improved plan approval flow and storage mechanism, enhancing user experience MCP Configuration System: Optimized MCP configuration scope architecture, improving configuration isolation and security Documentation Optimization: Removed redundant directory structure from documentation, simplifying document content 🐛 Bug Fixes Directory Trust Matching: Fixed issue where recursive trust patterns couldn't match the directory itself, ensuring directory trust functionality works correctly"},{"id":"/cli/release-notes/v2.31.1","title":"CodeBuddy Code v2.31.1 Release","body":"CodeBuddy Code v2.31.1 Release 🔧 Improvements & Optimizations File Search Tool: Optimized glob pattern processing logic, improving pattern standardization accuracy Shell Compatibility Hints: Added default Shell type in environment info and command execution prompts, ensuring generated commands are compatible with user Shell syntax Plugin Marketplace Git Operations: Disabled Git credential prompts and interactive SSH authentication, improving plugin installation experience in unattended environments 🐛 Bug Fixes File Permission Check: Fixed issue requiring repeated authorization when reading files within workspace; now trusted workspace directories automatically recursively trust all their subfiles"},{"id":"/cli/release-notes/v2.31.0","title":"🚀 CodeBuddy Code v2.31.0 Release","body":"🚀 CodeBuddy Code v2.31.0 Release ✨ New Features ACP HTTP Transport Protocol Added Streamable HTTP transport mode, providing more flexible integration options for ACP protocol: Support using ACP protocol through HTTP endpoints Enable via parameter Includes companion client SDK for quick integration Feedback Command Added command for quickly submitting feedback or bug reports, automatically opens browser with pre filled session information. Session History API The endpoint now supports retrieving conversation message lists from historical sessions, facilitating IDE integration development. Plugin Management Interface Enhancements Brand new plugin management experience with 6 new functional tabs: Discover/Browse: Discover and browse available plugins Installed: Manage installed plugins Marketplaces: Manage plugin marketplace sources Errors: View detailed error diagnostics, supporting 20+ error type categories Added command to verify plugin validity 🔧 Improvements New Model Support: Added support for Kimi K2 Thinking reasoning model UI Rendering Performance: Optimized terminal interface rendering, improved message display fluency Service Proxy: Hook scripts can call gateway services through service proxy LSP Integration: Improved Windows platform compatibility, fixed path space issues, enhanced C and other language server compatibility Permission Management: Optimized auto approval logic for safe commands in Plan mode Checkpoint Comparison: Support comparing disk files with snapshot difference statistics Conversation Recovery: Display checkpoint time information in recovery selector Workspace Rules: Optimized rule injection tags, improved AI rule recognition capability 🐛 Bug Fixes Rule Import: Fixed issue where imported rules were incorrectly skipped when Context Compression: Fixed issue where tool approval requests still popped up after compression 📝 Documentation Updates ACP Documentation: Added transport protocol selection and HTTP transport usage instructions En"},{"id":"/cli/release-notes/v2.30.1","title":"🚀 CodeBuddy Code v2.30.1 Release","body":"🚀 CodeBuddy Code v2.30.1 Release 🔧 Improvements File Search Tool: Optimized search logic, improved code readability and execution efficiency"},{"id":"/cli/release-notes/v2.30.0","title":"🚀 CodeBuddy Code v2.30.0 Release","body":"🚀 CodeBuddy Code v2.30.0 Release ✨ New Features Built in Plugin Marketplace Added CodeBuddy official plugin marketplace, providing officially recommended quality plugins for users to quickly discover and install. 🔧 Improvements Conversation Compression Display: Improved the interface display of conversation compression feature, providing clearer visual feedback File Search Pagination: Added and parameter support for Glob tool, enabling pagination processing for large search results Content Search Pagination: Added parameter and optimized handling for Grep tool, enhancing search result flexibility API Key Configuration: Support configuring API Key through settings, providing more flexible authentication options MCP Configuration Path Display: Improved MCP server configuration file path display logic, correctly showing path information for all configuration scopes MCP Service Management: Disabled MCP services can now view their detail pages Tool Permission Control: Optimized tool permission approval process, enhancing security control capabilities for specific tool operations Directory Trust Optimization: Users can now choose to trust the current directory, parent directory, or recursively trust all subdirectories in the directory trust prompt, avoiding repeated authorization for subdirectories Checkpoint Protocol Optimization: Extracted common data structures, reduced code duplication, optimized session data structures and restore conversation UI"},{"id":"/cli/release-notes/v2.29.0","title":"🚀 CodeBuddy Code v2.29.0 Release","body":"🚀 CodeBuddy Code v2.29.0 Release ✨ New Features Session Resume Support Added session resume functionality, supporting seamless resumption and switching of existing sessions in IDE integration scenarios, improving continuity and efficiency of cross session workflows. LSP Plugin Support Added Language Server Protocol plugin support, providing real time code intelligence for AI: Understand code structure, type definitions, and function signatures Support cross file symbol navigation and reference lookup Improve accuracy and efficiency of code analysis 🔧 Improvements Authentication Performance: Optimized authentication flow, reduced unnecessary configuration checks, improved startup speed UI Component Optimization: Improved loading state display component, enhanced rendering efficiency and code structure Sub agent Tracking: Enhanced internal tracking mechanism for sub agent task execution, improved event stream processing accuracy 🐛 Bug Fixes Session Management: Fixed CLI Agent session ID management issue, improved session persistence and recovery stability Startup Command: Fixed issue where command could not execute properly Network Exception Handling: Fixed error propagation issue caused by network exceptions during sub agent execution, improved task execution stability Todo List: Optimized command data loading logic, supports recovering todo list from file system MCP Connection: Improved MCP server connection mechanism, supports custom timeout configuration, improved connection reliability 📝 Documentation Updates Authentication: Restructured IAM documentation, added quick start guide and scenario based authentication configuration examples Plugin Development: Updated plugin development documentation, added LSP configuration guide and usage examples Release Notes: Added v2.28.1 release notes documentation Documentation Index: Updated CLI documentation index mapping"},{"id":"/cli/release-notes/v2.28.1","title":"🚀 CodeBuddy Code v2.28.1 Release","body":"🚀 CodeBuddy Code v2.28.1 Release 🐛 Bug Fixes Double ESC rollback feature: Fixed an issue where pressing ESC twice consecutively when the input field was empty failed to trigger the conversation rollback feature correctly. Now you can use the keyboard shortcut to quickly access the conversation rollback panel"},{"id":"/cli/release-notes/v2.28.0","title":"🚀 CodeBuddy Code v2.28.0 Release","body":"🚀 CodeBuddy Code v2.28.0 Release ✨ New Features Code Security Review Command: Added command for professional code security audits to identify potential vulnerabilities Conditional Rule Loading: Support for automatically loading relevant rules based on file operations, configured via the field matching patterns Modular Rule Management: Support for organizing rule files in the directory with subdirectory categorization Local Memory Configuration: Added file support for personal preference settings, excluded from version control AI Model Expansion: Added support for GLM 4.6V and DeepSeek V3.2 models Homebrew Installation: macOS/Linux users can now install directly via 🔧 Improvements & Optimizations Custom Command Rendering: Improved command template parsing with support for inline Bash command execution Memory Loading Mechanism: Optimized rule triggering for improved loading efficiency MCP Tool List: Enhanced stability when fetching server tools Error Message Optimization: Improved error message readability for easier troubleshooting Enhanced Logging: Added detailed logs for settings management to facilitate debugging Homebrew Update Detection: Now correctly detects updates for Homebrew installations MCP Output Limits: Improved tool output size calculation method MCP Timeout Configuration: Support for configuring connection timeout via environment variables 🐛 Bug Fixes Agent Tool Configuration: Fixed file reading capability configuration issue for compact agent Windows IDE Connection: Improved Windows platform IDE process detection for better connection stability"},{"id":"/cli/release-notes/v2.27.3","title":"🚀 CodeBuddy Code v2.27.3 Release","body":"🚀 CodeBuddy Code v2.27.3 Release 🔧 Improvements & Optimizations MCP server status display: Improved status presentation for pending approval servers, providing clearer visibility into connection states Auto update stability: Optimized update lock mechanism to prevent update loops in edge cases File search consistency: Unified file ignore rules management, improving search result accuracy UI responsiveness: Simplified output panel layout for faster interface response 🐛 Bug Fixes Complex task handling: Fixed issues where subtasks couldn't complete due to execution limits, now capable of handling more complex multi step tasks Context compression quality: Improved file reading capability during context compression, enhancing content accuracy after compression Subtask stability: Fixed unexpected message forwarding issues in subtasks, improving task execution isolation SDK mode optimization: Improved handling logic for permission denials, enhancing SDK integration experience"},{"id":"/cli/release-notes/v2.27.2","title":"🚀 CodeBuddy Code v2.27.2 Release","body":"🚀 CodeBuddy Code v2.27.2 Release 🐛 Bug Fixes Alpine Linux compatibility fix: Resolved crash issues when running on Alpine and other musl based systems, improving cross platform stability MCP connection optimization: Fixed transport layer conflicts caused by concurrent connection requests, improving connection stability Command execution optimization: Improved MCP initialization logic for one time commands, reducing unnecessary connection overhead"},{"id":"/cli/release-notes/v2.27.1","title":"🚀 CodeBuddy Code v2.27.1 Release","body":"🚀 CodeBuddy Code v2.27.1 Release 🔧 Improvements & Optimizations Enhanced error messages: Improved accuracy and readability of error messages to help you identify and resolve issues faster Network connection enhancement: Automatic detection of network fluctuations with retry mechanism, improving service stability and availability UI display improvements: Unified presentation of tool call results and async task completion notifications for a more consistent interaction experience 🐛 Bug Fixes File path suggestions optimization: Fixed inaccurate path suggestions during file search, improving input efficiency Input experience improvement: Eliminated suggestion list flickering during interactive input for a smoother input experience Startup speed boost: Resolved blocking issues during plugin marketplace initialization, accelerating startup response time Token statistics accuracy: Fixed token calculation logic to ensure accurate usage statistics Error diagnostics enhancement: Improved error message extraction and display mechanism, providing more detailed and useful diagnostic information Network retry optimization: Refined handling strategy for timeouts and connection interruptions, reducing operation failures caused by network fluctuations"},{"id":"/cli/release-notes/v2.27.0","title":"🚀 CodeBuddy Code v2.27.0 Release","body":"🚀 CodeBuddy Code v2.27.0 Release ✨ New Features Conversation Rewind: New command that allows rewinding the conversation to a previous message point, with options to rewind conversation only, code only, or both File Checkpoints: Support for automatically creating file checkpoints during sessions, allowing file restoration to previous states when rewinding Plugin Marketplace Auto Update: Support for enabling auto update for the plugin marketplace, automatically syncing marketplace content on startup, executed asynchronously in the background without affecting startup speed 🔧 Improvements & Optimizations Shortcut Enhancement: New double press ESC shortcut to activate rewind feature. When the input box is empty, pressing ESC twice quickly enters the conversation rewind panel 🐛 Bug Fixes Plugin Config Parsing Fix: Fixed plugin marketplace configuration parsing issues, supporting multiple configuration formats to improve configuration compatibility Build Script Permission Fix: Fixed issue where binary file executable permissions were lost during wheel package build process"},{"id":"/cli/release-notes/v2.26.0","title":"🚀 CodeBuddy Code v2.26.0 Release","body":"🚀 CodeBuddy Code v2.26.0 Release ✨ New Features Skills Panel: Added command to quickly view all loaded Skills (including user level, project level, and plugin level), displaying estimated token consumption to help you better manage and optimize context usage 🔧 Improvements and Optimizations Context Information Display Optimization: Enhanced command to improve the display of skills and custom commands, grouping by scope and sorting by token usage, giving you clear insight into context consumption details Task List Persistence: Task lists in sessions are now automatically saved, ensuring complete task state is maintained even after context compression, making long duration session management more reliable Terminal and Editor Support Expansion: Added automatic recognition support for Kitty and Alacritty terminals and Zed editor; expanded JetBrains IDE series recognition capabilities (including IntelliJ IDEA, WebStorm, PhpStorm, GoLand, Rider, CLion, RubyMine, DataGrip, etc.) Tool Invocation Stability Enhancement: Improved tool name matching capabilities to increase success rate and accuracy of Agent tool invocations Code Diff Experience Enhancement: Improved text highlighting in the diff view for easier and more efficient code reviews Code Size Optimization: Removed unused internal tools to reduce program size 🐛 Bug Fixes Sub Agent Event Handling: Fixed the issue where sub agent task result events were duplicately propagated to the main session, improving stability of multi agent collaboration"},{"id":"/cli/release-notes/v2.25.1","title":"🚀 CodeBuddy Code v2.25.1 Release","body":"🚀 CodeBuddy Code v2.25.1 Release ✨ New Features SDK System Prompt Configuration: SDK supports customizing system prompts through configuration options, flexibly controlling AI assistant behavior and response style 🔧 Improvements File Search Performance Optimization: Added search result deduplication and throttling mechanisms, significantly improving search response speed for large codebases Enhanced Large Repository Support: Added file and directory count limit protection mechanism to prevent memory issues in extremely large repositories Directory Browsing Optimization: Search results now prioritize displaying directories for quick location of project structure Error Message Display Improvements: Optimized diagnostic information for authentication errors to help locate and resolve issues faster Tool Control Optimization: Improved session level tool disabling mechanism, providing more granular feature control 🐛 Bug Fixes Streaming Response Handling Fix: Fixed exception handling when response is empty, improving error message accuracy MCP Permission Batch Settings: Support for wildcard syntax to approve all tools of a server at once, simplifying permission management process Multi line Input Navigation Fix: Corrected cursor positioning behavior of Home/End keys during multi line text input Editor Error Prompt Optimization: Improved error prompt logic when external editor fails to open Search Timeout Optimization: File search timeout adjusted to 30 seconds to prevent zombie processes from consuming system resources"},{"id":"/cli/release-notes/v2.25.0","title":"🚀 CodeBuddy Code v2.25.0 Release","body":"🚀 CodeBuddy Code v2.25.0 Release ✨ New Features Plan Mode Tool: Agent can proactively enter planning phase before executing complex tasks, helping you better understand and confirm the execution plan Enhanced Model Support: Added support for more powerful reasoning models, providing longer context windows and stronger reasoning capabilities 🔧 Improvements Enhanced Error Diagnostics: Provides more detailed error messages on authentication failures to help quickly locate and resolve issues; optimized request tracing functionality for easier troubleshooting of complete request chains MCP Tool Permission Management: Support for saving tool permission settings at the project level. Using the \"Don't ask again\" option now applies across the entire project, improving multi project workflow efficiency Agent Panel Optimization: More clearly displays different types of Agents; improved command search ranking algorithm to help you find desired commands faster; expanded external editor support range with better error prompts Input Experience Improvements: Optimized responsiveness and smoothness of input prompt box; improved display effects of reverse search functionality to enhance interaction experience 🐛 Bug Fixes Session Context: Fixed context passing issues in agent service to ensure conversation information is correctly preserved and passed Large File Reading: Added token count check for file reading to avoid errors caused by exceeding model context limits when reading extremely large log files"},{"id":"/cli/release-notes/v2.24.0","title":"🚀 CodeBuddy Code v2.24.0 Release","body":"🚀 CodeBuddy Code v2.24.0 Release ✨ New Features Built in Plugin Marketplace: Support for pre configured official recommended plugin marketplace through product configuration, with automatic installation on startup, making it easier for users to discover and use high quality plugins 🔧 Improvements Background Task Execution: Refactored task management module to improve the stability and reliability of background task execution Todo Item Experience: Optimized todo item status update mechanism to improve UI responsiveness 🐛 Bug Fixes Tool Permission Check: Fixed tool permission check failure in SDK mode to ensure tool invocation security External Editor Paste: Fixed text processing issues when pasting content from external editors, improving input experience Sub agent Tool Inheritance: Fixed tool inheritance logic in sub agent configuration to ensure correct default tool permissions are obtained Context Trimming Timing: Optimized conversation history trimming strategy to avoid errors caused by exceeding model context limits"},{"id":"/cli/release-notes/v2.23.5","title":"🚀 CodeBuddy Code v2.23.5 Release","body":"🚀 CodeBuddy Code v2.23.5 Release 🔧 Improvements & Optimizations Slash Command Permission Control: Support fine grained tool permission configuration for custom commands, enhancing command execution security and flexibility 🐛 Bug Fixes ACP Mode Permission Request: Fixed tool call permission request failure in ACP protocol mode, ensuring proper user authorization before tool execution Subagent Tool Access: Fixed subagent tool access failure when MCP server names contain special characters, improving multi agent collaboration stability Tool Permission Isolation: Optimized subagent tool permission management, ensuring each agent receives correct tool access permissions"},{"id":"/cli/release-notes/v2.23.0","title":"🚀 CodeBuddy Code v2.23.0 Release","body":"🚀 CodeBuddy Code v2.23.0 Release Release Date: 2025 12 22 ✨ New Features Agent SDK Permission Control Support: SDK now supports tool invocation permission management, allowing clients to approve or reject tool execution requests Agent SDK User Q&A Support: SDK now supports AskUserQuestion tool, enabling AI agents to ask users questions and gather feedback during execution 🚀 Performance Optimizations Significant @ File Search Performance Boost: Optimized file search experience in large repositories, resolving lag and crash issues caused by continuous input Implements single flight full enumeration: Only one runs per input round, avoiding redundant scans Background preloading of file lists: Uses useEffect to preload file lists during idle time, preventing first search freeze Only accepting latest query results: Uses requestId mechanism to discard outdated requests, preventing result flickering and redundant calculations Reduced memory allocation: Fuzzy matching directly handles string arrays, generating objects only for top results Automatic cleanup on context exit: Clears scan sessions when leaving context, avoiding memory overhead 🐛 Bug Fixes Fixed First Search Freeze: Uses useEffect background preloading; if preloading incomplete on first query, loads asynchronously without blocking UI response Fixed Windows Path Matching Accuracy: Ensures all paths are unified to POSIX style separators before processing, avoiding split failures Fixed execRg Timer Leak: Ensures timeout timers are properly cleaned up on all exit paths Upgrade Notes This release focuses on optimizing file search performance, especially when using symbol for file search in large codebases. If you frequently work with large projects, you'll notice significant improvements in search response speed and stability after upgrading. Technical Details File Search Architecture Optimization To address large repository performance issues, this release includes a comprehensive refactoring of the file search me"},{"id":"/cli/release-notes/v2.23.4","title":"🚀 CodeBuddy Code v2.23.4 Release","body":"🚀 CodeBuddy Code v2.23.4 Release 🔧 Improvements Context Statistics Enhancement: The command now displays token usage for MCP tools, helping users better understand context usage details UI Rendering Optimization: Improved terminal UI rendering performance and display stability, enhanced session state handling reliability 🐛 Bug Fixes Fixed First Login Issue: Resolved the issue where API Key authentication failed on first use Credential Validation Enhancement: Added credential existence check, automatically falling back to alternative authentication methods when credential retrieval fails Path Resolution Improvement: Support for expansion in configuration paths, improving configuration convenience Streaming Output Optimization: Fixed duplicate message identifiers in streaming output Session Recovery Stability: Enhanced null value checking to avoid runtime errors in specific scenarios Module Loading Optimization: Resolved circular dependency issues in product configuration management module"},{"id":"/cli/release-notes/v2.23.3","title":"🚀 CodeBuddy Code v2.23.3 Release","body":"🚀 CodeBuddy Code v2.23.3 Release 🔧 Improvements Stability Enhancement: Routine maintenance update to improve system stability"},{"id":"/cli/release-notes/v2.23.2","title":"🚀 CodeBuddy Code v2.23.2 Release","body":"🚀 CodeBuddy Code v2.23.2 Release ✨ New Features Model Support Expansion: Added support for GLM 4.7 model, providing users with more model options"},{"id":"/cli/release-notes/v2.22.0","title":"🚀 CodeBuddy Code v2.22.0 Release","body":"🚀 CodeBuddy Code v2.22.0 Release ✨ New Features SDK integration enhancement: Added bidirectional communication capability between SDK and CLI, supporting control signal transmission Flexible permission control: SDK can take over tool execution permissions to implement custom permission policies Hook system extension: Support SDK registration of tool execution hooks to implement custom interception and processing logic 🔧 Improvements UI experience enhancement: Optimized terminal loading box display for improved visual presentation and interactive experience 🐛 Bug Fixes Output compatibility enhancement: Fixed terminal control sequence interference with JSON output in SDK and pipeline mode to ensure correct data format Search accuracy improvement: Improved file ignore rule matching logic to enhance file search accuracy"},{"id":"/cli/release-notes/v2.21.0","title":"🚀 CodeBuddy Code v2.21.0 Release","body":"🚀 CodeBuddy Code v2.21.0 Release ✨ New Features New model support: Added GPT 5.2 model, providing you with more powerful reasoning capabilities and smarter code assistance 🔧 Improvements Loading status optimization: Improved display of terminal loading prompts to make the waiting process clearer and more intuitive 🐛 Bug Fixes Command execution stability: Fixed potential process hanging issues during subprocess calls to improve command execution reliability"},{"id":"/cli/release-notes/v2.20.1","title":"🚀 CodeBuddy Code v2.20.1 Release","body":"🚀 CodeBuddy Code v2.20.1 Release 🐛 Bug Fixes CLI mode detection optimization: Fixed output display issues for non interactive commands (such as install, update) in terminal First time installation compatibility: Fixed path detection failure during initial binary installation, ensuring a smoother first time installation experience Image content transfer: Fixed conversion handling of image content in streaming output to ensure correct image data display 🔧 Improvements Task progress display: Optimized visual effects of task progress bars to show task execution status more clearly Tool loading enhancement: Improved loading timing of dynamic tools to ensure sub agents can properly use all available tools Session management stability: Enhanced stability and performance of session lifecycle management Input interaction experience: Improved terminal input handling for a more stable interactive experience Connection reliability: Optimized protocol communication logic to improve connection stability"},{"id":"/cli/release-notes/v2.20.0","title":"🚀 CodeBuddy Code v2.20.0 Release","body":"🚀 CodeBuddy Code v2.20.0 Release ✨ New Features Usage Statistics Command: New command to easily view your usage metrics, including token consumption, session duration, model invocation counts, and other core data Multi dimensional Statistics View: Support for viewing usage by model category, with flexible switching between 7 day, 30 day, and all time ranges Visual Charts: Intuitive ASCII bar charts that clearly display usage distribution across different models 🔧 Improvements & Optimizations Session Management Enhancement: Optimized storage and cleanup mechanisms for session history, improving stability and reliability of session management Interactive Experience Improvement: Enhanced interaction experience for confirmation dialogs, input prompts, and session panels, making operations smoother and more convenient Keyboard Operation Optimization: Improved response stability and accuracy of keyboard shortcuts, boosting operational efficiency Installation Detection Improvement: Enhanced accuracy of installation method detection across different environments, reducing environment related issues Agent Framework Upgrade: Updated OpenAI agents SDK to the latest version, improving overall stability and performance 🐛 Bug Fixes Context Display Issue: Fixed issue where buffer information was still displayed when autocompact was disabled; display logic now behaves as expected Linux Compatibility: Resolved dynamic library loading errors that could occur when starting on older Linux systems Theme Display Optimization: Corrected theme color display in colorblind mode, improving visual experience Response Completeness: Ensured that result messages are always returned when tasks complete, preventing clients from being unable to exit properly Error Message Enhancement: Improved error logging with more detailed debugging information for easier troubleshooting"},{"id":"/cli/release-notes/v2.19.2","title":"🚀 CodeBuddy Code v2.19.2 Release","body":"🚀 CodeBuddy Code v2.19.2 Release 🔧 Improvements Conversation history management: Improved conversation history management efficiency, optimized memory usage, and support for longer conversation sessions Session state management: Optimized session state management logic, improving responsiveness and stability when switching between multiple sessions Code robustness: Enhanced internal type definitions, improving type safety and code maintainability Extension system enhancement: Improved hook execution mechanism before and after tool calls, providing better extensibility for plugin development Message display optimization: Optimized the organization and display logic of conversation messages, improving interaction experience fluency New visual theme: Adopted a new brand green color scheme, enhancing product visual identity Logo design upgrade: Optimized terminal logo display with a clean and refreshing robot avatar style"},{"id":"/cli/release-notes/v2.19.1","title":"🚀 CodeBuddy Code v2.19.1 Release","body":"🚀 CodeBuddy Code v2.19.1 Release 🔧 Improvements & Optimizations ACP Protocol Optimization: Enhanced command filtering mechanism and output display, improving protocol compatibility and interface clarity Image Reading Support: Read tool now supports directly reading and displaying image files, enabling richer file handling scenarios Interface Loading Optimization: Simplified session loading state management, improving interface responsiveness and stability 🐛 Bug Fixes Tool Approval Interface: Fixed incomplete information display issue in ACP protocol mode approval interface, improving readability Hook Integration Mechanism: Improved tool execution Hook invocation to ensure custom scripts can properly handle tool parameters Exit Process Enhancement: Fixed issue where session events were not properly triggered during CLI exit Terminal Compatibility: Fixed compatibility issues when pasting large amounts of text in some Windows and Linux terminals"},{"id":"/cli/release-notes/v2.19.0","title":"🚀 CodeBuddy Code v2.19.0 Release","body":"🚀 CodeBuddy Code v2.19.0 Release ✨ New Features Session Rename: Added command for quickly renaming the current session, supporting both direct argument passing and interactive panel operation Input Undo: Added keyboard shortcut support to undo text edits in the input box at any time 🔧 Improvements & Optimizations Session Resume Panel: Optimized the session resume interface for a more intuitive session management experience Connection Diagnostics Enhancement: Improved diagnostic information for network disconnection scenarios to facilitate troubleshooting"},{"id":"/cli/release-notes/v2.18.0","title":"🚀 CodeBuddy Code v2.18.0 Release","body":"🚀 CodeBuddy Code v2.18.0 Release ✨ New Features API Key Caching Support: Improves credential management response speed and efficiency, reducing wait times for frequent authentication. Supports custom cache refresh interval via environment variable 🔧 Improvements UI Performance Optimization: Reduces unnecessary interface re rendering, improving interaction fluency Paste Functionality Enhancement: Improves text paste processing speed and stability Command Display Optimization: Intelligently controls command metadata length, improving performance in long prompt scenarios Model Selection Update: Expands available model list, providing more options 🐛 Bug Fixes MCP OAuth Authentication Flow Fix: Resolves the issue requiring manual reconnection after authorization, improving authentication experience Terminal Compatibility Improvement: Fixes code highlighting display issues in tmux environments"},{"id":"/cli/release-notes/v2.17.0","title":"🚀 CodeBuddy Code v2.17.0 Release","body":"🚀 CodeBuddy Code v2.17.0 Release ✨ New Features IDE Integration Enhancement: Added IDE diff confirmation view and interactive panel, supporting intuitive code change review in IDE Smart Confirmation Flow: Introduced IDE confirmation service and interceptors, improving tool call security and user experience Terminal Title Auto update: CLI intelligently updates terminal title based on conversation context, helping users quickly identify work content across multiple terminal windows Windows Terminal Keyboard Enhancement: Improved keyboard input handling for Windows terminal, enhanced multi line editing support. Added Windows Terminal auto configuration feature, supporting Shift+Enter line break shortcut 🔧 Improvements & Optimizations Tool Call Interface Optimization: Improved display of file reading and search tools, providing clearer information presentation Permission Management Enhancement: Added explicit permission confirmation flow for file operation tools, improving security Search Experience Optimization: Improved permission checking mechanism for file search tools, providing smoother experience in trusted directories Interface Interaction Improvement: Enhanced multi select and input component interaction experience in terminal interface Shortcut Key Adjustment: Changed expand detailed record shortcut from Ctrl+R to Ctrl+O, avoiding conflict with terminal reverse search function History Message Display Optimization: Improved display of conversation records, providing clearer viewing experience Update Notification Improvement: Optimized version update notification display mechanism, improving stability 🐛 Bug Fixes ACP Protocol Compatibility: Fixed issue where sessions were incorrectly terminated in ACP mode, ensuring normal message stream transmission Custom Model Loading: Improved configuration file read error handling, improving custom model loading stability Message Display Fix: Fixed issue where incomplete messages from history conversations appeared repea"},{"id":"/cli/release-notes/v2.16.0","title":"CodeBuddy Code v2.16.0 Release","body":"CodeBuddy Code v2.16.0 Release ✨ New Features Input History Reverse Search: Support for shortcut to perform interactive search in command history, quickly locate and reuse previous input content 🔧 Improvements Input Experience Upgrade: Refactored input box state management for improved response speed and interaction fluidity Paste Function Optimization: Enhanced clipboard paste experience with better handling of images and large text content Command Quick Settings: command now supports direct input of model ID for quick switching Intelligent Update Strategy: Automatically selects the optimal update method based on package manager Complete Diagnostic Information: Doctor panel displays auto update status and package manager information 🐛 Bug Fixes Fixed issue where terminal output interfered with communication in ACP mode Fixed abnormal state after deleting keywords in reverse search Fixed incomplete message passing in sub agents Fixed potential exceptions during command execution"},{"id":"/cli/release-notes/v2.15.1","title":"CodeBuddy Code v2.15.1 Release","body":"CodeBuddy Code v2.15.1 Release 🔧 Improvements Message Debugging Enhancement: Added timestamp field to streaming output for easier debugging and performance analysis Code Architecture Optimization: Improved message processing logic structure for better code maintainability and reusability Vim Mode Operation Optimization: Improved word movement logic for more accurate and smoother cursor navigation 🐛 Bug Fixes State Management Optimization: Fixed issue where user interrupt state was overwritten by asynchronous events, ensuring interrupt state is correctly maintained"},{"id":"/cli/release-notes/v2.15.0","title":"🚀 CodeBuddy Code v2.15.0 Release","body":"🚀 CodeBuddy Code v2.15.0 Release ✨ New Features Terminal Notification System: When the terminal is running in the background, system notifications will be sent to remind you to check the results after the AI assistant completes a task 🔧 Improvements Proxy Configuration Enhancement: Support for NOPROXY environment variable to specify which domains should bypass the proxy Vim Mode Navigation Optimization: Improved accuracy of the command for smoother word to word navigation Diagnostic Panel Optimization: Clearer settings information display with summary view for complex configurations TODO Tool Enhancement: More stable task list parsing with better error tolerance 🐛 Bug Fixes Sub agent Execution Stability: Fixed potential response interruption issues when executing multiple sub agents consecutively Security Update: Fixed critical security vulnerabilities in dependency packages to improve overall security /clear Command Improvement: Permission mode settings are no longer accidentally reset after using the clear screen command"},{"id":"/cli/release-notes/v2.14.1","title":"🚀 CodeBuddy Code v2.14.1 Release","body":"🚀 CodeBuddy Code v2.14.1 Release 🔧 Improvements CLI Interactive Experience Optimization: Improved command line interface interaction flow and user feedback mechanism for smoother operations Session Management Enhancement: Improved stability and responsiveness of session interruption handling, reducing the impact of unexpected interruptions Vim Mode Refinement: Optimized keyboard operations and context management in Vim mode for a smoother editing experience Tool Execution Optimization: Improved performance and accuracy of tool invocation and result processing for faster task response"},{"id":"/cli/release-notes/v2.14.0","title":"CodeBuddy Code v2.14.0 Release","body":"CodeBuddy Code v2.14.0 Release ✨ New Features Vim Editor Mode: Added Vim style editing support with NORMAL and INSERT mode switching, supporting standard Vim navigation and editing commands, providing a familiar editing experience for Vim users IDE Selection Interaction: Added command with visual interface for selecting and managing IDE connections, making multi IDE collaboration scenarios more convenient 🔧 Improvements Terminal Emulation Optimization: Improved terminal emulation module under Bun runtime for better compatibility Windows Chinese Display Enhancement: Improved character encoding handling for command output, enhancing Chinese display compatibility on Windows platform Third party Service Compatibility Enhancement: Improved runtime polyfill mechanism to enhance compatibility with third party services Error Handling Enhancement: Improved log refresh mechanism safety to avoid errors when service is not initialized IDE Detection Enhancement: Improved terminal environment recognition logic to enhance IDE integration stability Environment Variable Handling Optimization: Improved boolean value parsing logic for environment variable to enhance configuration accuracy 🐛 Bug Fixes Command Execution Optimization: Normalized system command execution parameters to prevent unexpected output interfering with normal flow IDE Context Cleanup: Fixed issue where selection content remained after IDE disconnection, ensuring session context is properly reset Concurrent Tool State Fix: Fixed state transition issues when multiple tools execute concurrently Message Deduplication Optimization: Fixed UI display issues caused by duplicate message group additions"},{"id":"/cli/release-notes/v2.13.0","title":"🚀 CodeBuddy Code v2.13.0 Release","body":"🚀 CodeBuddy Code v2.13.0 Release ✨ New Features Token Analysis Command: Added command to view token usage distribution across modules in the current session, helping understand context consumption IDE Auto Connect: CLI automatically detects and establishes communication with local IDE on startup, with real time connection status displayed in the status bar Ripgrep Configuration Option: Added environment variable to choose between system installed ripgrep or the built in version 🔧 Improvements Loading Interface Optimization: Improved display style of tool call results and loading prompts for better visual experience Model Output Configuration: Support for dynamically adjusting model output limits via environment variables Skill Loading Acceleration: Optimized skill scanning mechanism to improve startup speed Enhanced Shell Compatibility: Improved default shell configuration for better cross platform stability 🐛 Bug Fixes Command Execution Feedback: Fixed missing running status prompt when executing custom commands IDE File Prompt: Improved file open prompt logic to correctly display prompts even when no content is selected Encoding Detection Optimization: Improved system encoding detection mechanism to avoid error output interference"},{"id":"/cli/release-notes/v2.12.0","title":"🚀 CodeBuddy Code v2.12.0 Release","body":"🚀 CodeBuddy Code v2.12.0 Release ✨ New Features Standalone Theme Selection Panel: Added command with an interactive theme selection panel, supporting multiple theme variants including dark, light, colorblind friendly, ANSI, and more Real time Theme Preview: Preview different themes in real time within the theme panel to easily find the color scheme that suits you User Feedback Survey: Added user experience feedback survey functionality to help us better understand your usage experience Output Style Management: Support for customizing AI response output formats to meet personalized needs 🔧 Improvements Theme System Refactoring: Standalone theme management panel provides a more professional configuration experience Enhanced Terminal Compatibility: Improved recognition and support for older iTerm terminal versions Enhanced File Search: Support for searching hidden files and directories, never miss important configuration files again Build Optimization: Improved application startup speed for more responsive performance Feedback Survey Optimization: Enhanced responsiveness and user experience of feedback components 🐛 Bug Fixes Error Retry Optimization: Improved recognition mechanism for context too long errors, reducing unnecessary retries and enhancing conversation stability Skill Configuration Parsing: Fixed issue with multi line text parsing failures in skill configuration files"},{"id":"/cli/release-notes/v2.11.0","title":"🚀 CodeBuddy Code v2.11.0 Release","body":"🚀 CodeBuddy Code v2.11.0 Release ✨ New Features Sub agent Model Selection: Support dynamic model selection when invoking sub tasks, allowing flexible adjustment based on task complexity to optimize cost and performance Sub agent Session Resume: Support resuming previous sub task sessions based on existing context, suitable for staged analysis and iterative optimization scenarios 🔧 Improvements Project level Conversation Memory Enhancement: Support cascading loading of CODEBUDDY.md files from parent directories, automatically inheriting project context Interactive Command Support Enhancement: Improved interactive handling capabilities for terminal commands, enhancing execution stability and user experience Terminal Display Optimization: Enhanced color and format preservation in terminal output, improving visual experience Exit Experience Optimization: Improved double ESC exit logic with increased timeout and visual feedback prompts Conversation Memory Optimization: Improved conversation history loading mechanism, enhancing context management efficiency Plugin Loading Stability Enhancement: Single command loading failure no longer affects normal usage of other commands Input Experience Optimization: Improved support for special characters and emojis, enhancing editing fluency 🐛 Bug Fixes Image Paste Fix: Fixed format recognition issue when pasting images, ensuring correct image upload Response Stability Enhancement: Fixed potential infinite retry loop issue when model output is extremely long Configuration Merge Fix: Fixed deduplication issue when merging configuration items, avoiding duplicate configuration entries Editor Interaction Fix: Resolved content handling exception when returning from external editor Plugin Path Fix: Fixed installation path recognition issue for local directory type plugins"},{"id":"/cli/release-notes/v2.10.1","title":"🚀 CodeBuddy Code v2.10.1 Release","body":"🚀 CodeBuddy Code v2.10.1 Release 🐛 Bug Fixes Keyboard Input Optimization: Improved terminal keyboard input handling logic, enhancing input response stability"},{"id":"/cli/release-notes/v2.10.0","title":"🚀 CodeBuddy Code v2.10.0 Release","body":"🚀 CodeBuddy Code v2.10.0 Release ✨ New Features Sandbox Management Command: Added slash command to quickly enable or disable sandbox protection mode for Bash commands 🔧 Improvements ACP Protocol Mode Optimization: Improved model information display in ACP mode, providing clearer runtime status Sandbox Architecture Upgrade: Optimized sandbox mechanism for Bash command execution, enhancing execution performance and system stability Terminal Interaction Enhancement: Improved keyboard input handling and command parsing, enhancing terminal response speed and input accuracy File Reference Experience Enhancement: Automatically display file name and size when referencing files using Startup Performance Optimization: Skip unnecessary initialization steps in non interactive mode, accelerating startup speed Configuration Query Optimization: Automatically merge multi level configurations and return final results for more convenient usage UI Performance Enhancement: Streamlined login interface components, optimizing rendering performance Permission Control Enhancement: Improved permission matching logic for Skill tool 🐛 Bug Fixes ACP Protocol Permission Request: Fixed issue where permission requests could not be properly triggered when sub tasks execute tools Debug Log Enhancement: Ensure debug logs are correctly written to corresponding session files Message Queue Stability: Fixed format issues during message processing, improving display stability Error Handling Enhancement: Improved fault tolerance when tool parameters are empty"},{"id":"/cli/release-notes/v2.9.0","title":"🚀 CodeBuddy Code v2.9.0 Release","body":"🚀 CodeBuddy Code v2.9.0 Release ✨ New Features Authentication Success Notification: Added Hook notification event after successful user login, supporting triggering custom scripts upon authentication completion to enable automated workflows after login"},{"id":"/cli/release-notes/v2.8.6","title":"🚀 CodeBuddy Code v2.8.6 Release","body":"🚀 CodeBuddy Code v2.8.6 Release 🔧 Improvements and Optimizations Enhanced Terminal Input Processing: Improved cross platform input parsing mechanism, enhancing terminal stability and compatibility Optimized Paste Experience: Refined large text paste handling with automatic paste mode recognition, improving text input convenience Message Processing Mechanism Optimization: Refactored internal message queue, improving conversation response speed and system stability Enhanced UI Rendering Performance: Optimized rendering efficiency of the main application interface and chat view, providing a smoother interactive experience Simplified Command Execution Flow: Optimized terminal command execution logic, improving execution efficiency 🐛 Bug Fixes Protocol Mode Configuration Persistence: Fixed issue where configuration was lost in multi turn conversations under client protocol mode, ensuring session stability tmux Clipboard Paste: Fixed issue where clipboard images could not be pasted in tmux terminal environment"},{"id":"/cli/release-notes/v2.8.5","title":"🚀 CodeBuddy Code v2.8.5 Release","body":"🚀 CodeBuddy Code v2.8.5 Release 📚 Documentation Enhancement GitLab CI/CD Integration Guide: Added comprehensive CI/CD integration documentation to help you easily use CodeBuddy Code in GitLab pipelines, including detailed configuration examples, usage scenarios, and common troubleshooting solutions"},{"id":"/cli/release-notes/v2.8.4","title":"🚀 CodeBuddy Code v2.8.4 Release","body":"🚀 CodeBuddy Code v2.8.4 Release 🔧 Improvements Type Definition Optimization: Improved code organization structure for enhanced long term maintenance efficiency 🐛 Bug Fixes Permission Mode Synchronization: Fixed an issue where permission settings were not properly applied during subtask execution, ensuring consistency in permission control for batch operations"},{"id":"/cli/release-notes/v2.8.3","title":"🚀 CodeBuddy Code v2.8.3 Release","body":"🚀 CodeBuddy Code v2.8.3 Release 🔧 Improvements and Optimizations Gemini Model Support Expansion: Added support for Gemini 3.0 Pro model, providing more powerful reasoning capabilities and larger context windows to handle more complex programming tasks Intelligent File Processing Optimization: Automatically identifies and skips reference processing for oversized files, effectively avoiding performance issues and improving response speed in large projects Code Architecture Stability Enhancement: Optimized middleware dependency injection mechanism, service initialization workflow, and session type definitions to improve system stability and code maintainability Session Management Experience Improvement: Enhanced data processing logic in the session recovery panel for a smoother session management experience Permission Control Reliability: Improved directory trust state management for more precise and reliable permission control 🐛 Bug Fixes Remote Execution Environment Connection Stability: Optimized authentication token handling mechanism to improve stability when connecting to sandboxes and remote execution environments Shell Command Compatibility: Enhanced command execution environment to support tools requiring terminal interaction, improving the success rate of various command executions"},{"id":"/cli/release-notes/v2.8.2","title":"🚀 CodeBuddy Code v2.8.2 Release","body":"🚀 CodeBuddy Code v2.8.2 Release 🔧 Improvements Conversation Context Enhancement: Improved conversation message processing mechanism to ensure complete contextual information is properly retained and passed through multi turn conversations, enhancing the coherence and accuracy of AI responses"},{"id":"/cli/release-notes/v2.8.1","title":"🚀 CodeBuddy Code v2.8.1 Release","body":"🚀 CodeBuddy Code v2.8.1 Release 🔧 Improvements and Optimizations Plan Mode Refactoring: Refactored Plan mode with an entirely new Sub Agent architecture, providing smarter and more stable task planning and execution capabilities Smart Model Image Detection: Automatically detects model image support capabilities and intelligently handles image input when the model doesn't support it, improving cross model usage fluency Runtime Environment Health Check: Automatically detects Node.js version at startup to proactively avoid environment compatibility issues and ensure stable tool operation ACP Protocol Experience Enhancement: Automatically pushes command list when creating sessions to support intelligent auto completion; optimized authentication methods to automatically recommend the best login options based on network environment Permission Command Risk Adjustment: Optimized risk classification strategy for privilege escalation commands like sudo/su, reducing unnecessary confirmations while maintaining security and improving efficiency 🐛 Bug Fixes Git Operation Security Enhancement: Improved dangerous command detection rules to more accurately identify and block high risk Git operations such as force push and branch deletion Windows Path Compatibility: Fixed case sensitivity issues with paths on Windows systems, improving stability of cross platform file operations Non Interactive Mode Tool Control: Fixed behavior logic of user question answer tool in non interactive mode to ensure smooth automated workflow execution Exclusive Edition Environment Adaptation: Fixed environment recognition issues in exclusive editions to ensure correct configuration loading Clipboard Detection Compatibility: Temporarily adjusted clipboard detection strategy to resolve false trigger issues in certain environments and improve user experience"},{"id":"/cli/release-notes/v2.8.0","title":"🚀 CodeBuddy Code v2.8.0 Release","body":"🚀 CodeBuddy Code v2.8.0 Release ✨ New Features Native Editor Integration: Supports deep integration with editors like Zed through the ACP protocol, delivering a more seamless AI assisted development experience Intelligent Security Protection: Introduces a five level command risk classification system covering 9 major categories including file operations, Git management, container control, etc. High risk operations are automatically intercepted for confirmation, making AI automation more secure 🔧 Improvements and Optimizations Intelligent Dangerous Operation Recognition: Optimized risk assessment strategy to automatically identify Git operations that may cause data loss and elevate their risk level, with stricter protection for main branches Security Mode Enhancement: Improved security checks for permission bypass mode, requiring confirmation for extremely high risk operations in interactive scenarios, balancing automation and security Visual Prompt Upgrade: High risk command confirmation interface uses warning colors for highlighting, making potential dangerous operations immediately recognizable Document Parsing Efficiency Improvement: Optimized Markdown file processing performance for faster loading speed 🐛 Bug Fixes Security Approval Mechanism Reinforcement: Fixed vulnerability where high risk commands could potentially skip confirmation, ensuring all dangerous operations require user authorization Prompt Template Optimization: Eliminated duplicate content in system prompts to improve AI response accuracy"},{"id":"/cli/release-notes/v2.7.0","title":"🚀 CodeBuddy Code v2.7.0 Release","body":"🚀 CodeBuddy Code v2.7.0 Release ✨ New Features Token Counter Display Control: Added display toggle setting, allowing users to choose whether to show or hide Token usage statistics based on personal preference 🔧 Improvements and Optimizations Session Identifier Rule Optimization: Relaxed format restrictions for session IDs, supporting more flexible custom session identifiers Statistics Accuracy Improvement: Enhanced statistical logic for tool execution status to ensure accuracy of usage data 🐛 Bug Fixes Message Processing Reliability Enhancement: Strengthened message type validation mechanism to avoid processing exceptions caused by invalid data Error Feedback Mechanism Optimization: Improved exception information delivery process to provide clearer error messages Theme Adaptation Experience Optimization: Optimized color display algorithm to automatically adapt to dark and light themes, improving visual comfort"},{"id":"/cli/release-notes/v2.6.1","title":"🚀 CodeBuddy Code v2.6.1 Release","body":"🚀 CodeBuddy Code v2.6.1 Release 🔧 Improvements and Optimizations Error Handling Enhancement: Improved server side request error handling mechanism, enhancing the accuracy and readability of error messages for more efficient issue troubleshooting 🐛 Bug Fixes Image Paste Optimization: Optimized clipboard image reading mechanism, improved multi file paste support, and enhanced the stability and reliability of image pasting Plugin Marketplace Deduplication: Fixed the issue where duplicate entries might appear when loading the plugin marketplace. Now automatically filters marketplaces with the same name and source, improving interface cleanliness"},{"id":"/cli/release-notes/v2.6.0","title":"🚀 CodeBuddy Code v2.6.0 Release","body":"🚀 CodeBuddy Code v2.6.0 Release ✨ New Features GPT 5.1 Series Models: Added three new model options GPT 5.1, GPT 5.1 codex, and GPT 5.1 codex mini, offering larger context windows (supporting up to 272K tokens input) and enhanced reasoning capabilities, perfect for complex code analysis and long document tasks"},{"id":"/cli/release-notes/v2.5.0","title":"🚀 CodeBuddy Code v2.5.0 Release","body":"🚀 CodeBuddy Code v2.5.0 Release ✨ New Features Session Branch Management: Support creating new branches when resuming sessions, helping you better organize and manage different conversation topics Message Replay Confirmation: Automatically echo your input in non interactive mode to ensure you can double check commands before execution Custom Agent Configuration: Define your own AI assistant behaviors and capabilities through configuration files System Prompt Customization: Support customizing or extending system prompts to make the AI assistant better fit your workflow Settings Loading Control: Flexibly specify which sources to load configuration from (user level/project level/temporary settings) to meet different scenario needs External Configuration Import: Support loading additional settings from files or JSON strings for easy configuration sharing and reuse 🔧 Improvements & Optimizations More Flexible Command Execution: Customize Bash command timeout and output length via environment variables to adapt to different task requirements Verbose Logging Mode: Added verbose output switch to help you understand the AI assistant's execution process in depth Enhanced Streaming Messages: Support viewing complete incremental messages in streaming output mode, providing more transparent execution feedback Beautified Cost Statistics: Improved display format of usage cost statistics with better alignment for clearer readability Optimized Configuration Loading: Added product configuration caching mechanism to improve startup speed and runtime performance 🐛 Bug Fixes MCP Server Interaction Optimization: Resolved blocking issues caused by MCP server approval in non interactive mode; now supports pre configuring approval free servers Improved Terminal Compatibility: Fixed paste mode anomalies and ESC key delay issues in some terminal environments for smoother input experience Update Service Stability: Optimized automatic update check mechanism to avoid duplicate installations "},{"id":"/cli/release-notes/v2.4.0","title":"🚀 CodeBuddy Code v2.4.0 Release","body":"🚀 CodeBuddy Code v2.4.0 Release ✨ New Features Task Execution Turn Control: Added command line parameter, allowing you to precisely control the AI assistant's execution turns, avoiding infinite loops and improving task execution controllability 🔧 Improvements Execution Capability Enhancement: Default maximum execution turns increased from 100 to 500, providing more processing capacity for complex tasks and reducing task interruptions caused by turn limits External Editor Integration: Added Ctrl+G shortcut support for quickly invoking external editors like VSCode or Sublime Text to edit long text, improving input experience Log Saving Optimization: Improved log persistence mechanism to ensure all log information is completely saved when the process exits, facilitating troubleshooting Session Management Optimization: Improved historical session list display by automatically filtering internal sub agent sessions, making the session list clearer 🐛 Bug Fixes Native Version Command Compatibility: Fixed the issue where the command could not run properly in Native environment Telemetry Data Accuracy: Fixed the missing identification information in tool invocation telemetry data to ensure complete data reporting Auto update Stability: Enhanced the auto update lock mechanism in multi process scenarios to avoid update conflicts Sub agent Interruption Issue: Fixed the issue where sub agents could not respond to interrupt commands, improving interactive experience"},{"id":"/cli/release-notes/v2.3.1","title":"🚀 CodeBuddy Code v2.3.1 Release","body":"🚀 CodeBuddy Code v2.3.1 Release 🔧 Improvements File Editing Stability: Optimized string replacement logic to improve accuracy and reliability when handling special characters Plugin Marketplace Experience: Improved plugin source recognition capability and provided more friendly error messages, lowering configuration barriers Skills Debugging Experience: Optimized skill loading log output to display skill sources more clearly, facilitating troubleshooting Tool System Flexibility: Support for dynamically controlling tool availability based on runtime environment, improving system adaptability Command Input Efficiency: Improved slash command auto completion with exact match priority display to speed up command input Interface Rendering Performance: Optimized list component key attribute strategy to improve terminal interface stability and fluidity Image Paste Compatibility: Enhanced cmd+v image paste functionality with improved Windows system compatibility Configuration Interface Professionalism: Optimized prompt text in Hooks configuration panel to enhance product quality 🐛 Bug Fixes Hooks Documentation Improvement: Updated Hooks usage guide with improved documentation structure and examples to simplify configuration"}]