Skip to main content

Built-in Tools Reference

DesireCore provides 20 built-in tools, automatically updated with the client version. These tools require no installation—agents can use them out of the box.

File Operations

Read (Read File)

PropertyDescription
FunctionRead file content from the file system
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioView documents, read configurations, analyze code

Write (Write File)

PropertyDescription
FunctionCreate new files or completely overwrite existing files
Risk LevelMedium
Requires ConfirmationYes by default (ask mode)
Usage ScenarioCreate documents, generate reports, save results

Edit (Edit File)

PropertyDescription
FunctionPerform precise text replacements in files (send diff only)
Risk LevelMedium
Requires ConfirmationYes by default (ask mode)
Usage ScenarioModify configurations, update documents, code patching

Ls (List Directory)

PropertyDescription
FunctionList files and subdirectories in the specified directory
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioBrowse project structure, find files

NotebookEdit (Edit Jupyter Notebook)

PropertyDescription
FunctionReplace, insert, or delete specific cells in a Jupyter Notebook
Risk LevelMedium
Requires ConfirmationYes by default
Usage ScenarioData analysis, editing computational notebooks

Search Tools

PropertyDescription
FunctionQuickly search files using wildcard patterns
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioFind files by name pattern, e.g., *.md, src/**/*.ts
PropertyDescription
FunctionSearch for regex matches in file contents
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioSearch for function definitions in code, find configuration items

System Tools

Bash (Execute Command)

PropertyDescription
FunctionExecute shell commands
Risk LevelHigh
Requires ConfirmationYes
Usage ScenarioRun scripts, install dependencies, execute system operations

Which (Find Command)

PropertyDescription
FunctionCheck if a specified command is available on the system
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioCheck if tools are installed

GenerateUuid (Generate UUID)

PropertyDescription
FunctionGenerate unique identifiers
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioCreate unique IDs

Network Tools

WebFetch (Web Fetch)

PropertyDescription
FunctionFetch content from a specified URL, converting HTML to Markdown
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioFetch web information, read online documentation
PropertyDescription
FunctionSearch the internet and return results
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioQuery real-time information, search documentation

Agent Collaboration

SpawnAgent (Spawn Sub-Agent)

PropertyDescription
FunctionCreate sub-agents to process tasks in parallel
Risk LevelMedium
Requires ConfirmationYes by default
Usage ScenarioComplex task decomposition, parallel processing

Handoff (Handoff Task)

PropertyDescription
FunctionHand over the current task to another agent
Risk LevelMedium
Requires ConfirmationYes by default
Usage ScenarioCross-domain task transfer

RequestHelp (Request Help)

PropertyDescription
FunctionAgent requests help or confirmation from the user
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioEscalate to user when encountering uncertain situations

Knowledge & Memory

RecallConversation (Recall Conversation)

PropertyDescription
FunctionRetrieve historical conversation records
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioReview previous discussions

Skill (Invoke Skill)

PropertyDescription
FunctionInvoke installed skill packs
Risk LevelDepends on skill
Requires ConfirmationDepends on skill configuration
Usage ScenarioExecute professional tasks in specific domains

MCP Integration

MCPListResources / MCPReadResource

PropertyDescription
FunctionList and read resources provided by MCP servers
Risk LevelLow
Requires ConfirmationNo

MCPListPrompts / MCPGetPrompt

PropertyDescription
FunctionList and get prompt templates provided by MCP servers
Risk LevelLow
Requires ConfirmationNo

Work Management

ManageWorkDirs (Manage Work Directories)

PropertyDescription
FunctionManage agent work directory configuration
Risk LevelLow
Requires ConfirmationNo
Usage ScenarioSet root directory for file operations

Schedule (Create Scheduled Task)

PropertyDescription
FunctionCreate tasks that execute on a schedule
Risk LevelMedium
Requires ConfirmationYes
Usage ScenarioSet reminders, periodic data checks