Skip to content

Built-in Tool Configuration Guide

Click the 【Settings】 button in the plugin, then click 【Tools】 to view the built-in tools.

ToolDescription
read_fileUse this tool to view the contents of an existing file.
creat_new_fileCreates a new file or folder. Use only when the file does not exist and needs to be created.
run_terminal_commandExecutes terminal commands in the current directory. The shell is stateless and does not remember previous commands. If running background commands, always wrap them in a shell function and format them as sh -c '...'. Do not execute commands requiring special terminal privileges. Prefer terminal command scripts optimized for x86 and arm64 architectures, and use standard shell syntax.
file_glob_searchRecursively searches for files in the project using glob patterns. Supports "*" for recursive directory traversal. Excludes large numbers of build, cache, and credential-related files (use the cache tool instead). Output may be truncated—use precise matching patterns.
view_diffDisplays the diff of current working changes.
read_currently_open_fileReads the file currently open in the IDE. If the user refers to a file you cannot see, or if requested content appears missing, try using this tool.
lsLists files and folders in a specified directory.
creat_rule_blockCreates a “rule” that can be referenced in subsequent conversations. Use this when you want to establish consistent coding standards/preferences or avoid repeating mistakes.
Rule Types:
Always: Contains only “rule” (always included in model context)
Auto Attached: Contains “rule”, “glob”, and/or “regex” (triggered when files match the pattern)
Agent Requested: Contains “rule” and “description” (AI decides whether to apply based on description)
Manual: Contains only “rule” (included only when manually invoked)
request_ruleRetrieves additional “rules” with more context/instructions based on their descriptions.
Available rules: No rules available.
edit_existing_fileEdits an existing file. If you are unfamiliar with the file’s content, read it first. When handling code modification requests, provide concise code snippets that highlight only necessary changes, and use simplified placeholders for unmodified sections.
single_find_and_replacePerforms an exact string replacement within a file.
Important Notes:
– Always use the read_file tool before editing to understand the latest file content and context. The user may be editing the same file concurrently.
– This tool must not be called in parallel with other tools.
– When editing text output from read_file, preserve exact whitespace and indentation.
– Only use emojis if explicitly requested by the user. Avoid adding emojis to files unless instructed otherwise.
– Use replace_all to replace or rename strings throughout the entire file.