Skip to main content

Built-in Tools Reference

DesireCore built-in tools evolve with the client. This page groups common tools by capability area; the exact tools available to an agent depend on the agent, enabled skills, permissions, and platform.

ToolFunctionRiskConfirmation
ReadRead text, images, PDFs, and large file rangesLowNo
WriteCreate or overwrite filesMediumUsually
EditReplace precise text rangesMediumUsually
NotebookEditEdit Jupyter Notebook cellsMediumUsually
LsList directory contentsLowNo
GlobSearch by filename patternLowNo
GrepSearch file contentsLowNo
ToolSearchSearch deferred tools, connectors, and external capabilitiesLowNo

Read chooses a strategy by file type. PDFs may be read as text, rendered page by page for vision models, or loaded by range for large files.

System and Workspace

ToolFunctionRiskConfirmation
BashRun shell commandsHighYes
PowerShellRun PowerShell commands on WindowsHighYes
WhichCheck command availabilityLowNo
ManageWorkDirsManage working directoriesMediumUsually
GenerateUUIDGenerate UUIDsLowNo
JsonRepairRepair common JSON formatting problemsLowNo

Web and Browser

ToolFunctionRiskConfirmation
WebFetchFetch a webpage as MarkdownLowNo
WebSearchSearch the webLowNo
HttpRequestSend HTTP requests, primarily for Windows environmentsMediumDepends
Browser*Control browser tabs, clicks, scrolling, screenshotsLow-MediumDepends
SitePattern*Read or write site usage patternsLow-MediumMay be needed
LocalBookmarksSearch local browser bookmarks/history hintsLowNo

Browser, SitePattern, and LocalBookmarks tools are Web Access skill-scoped tools. See Web Access.

Collaboration and Tasks

ToolFunctionRiskConfirmation
DelegateDelegate work to another agent, team, or preset flowMediumDepends
SpawnAgentCreate a temporary sub-agentMediumUsually
HandoffTransfer work to another agentMediumUsually
RequestHelpAsk a persistent agent for helpMediumUsually
SendMessage / SendUserMessageCommunicate between agents or proactively message the userLowNo
AskUserQuestionAsk the user a structured questionLowNo
ManageTeamCreate or adjust an agent teamMediumDepends
TaskCreate / TaskUpdateMaintain the floating task boardLowNo
TaskList / TaskGetQuery task board stateLowNo

Context, Memory, and Skills

ToolFunctionRiskConfirmation
RecallConversationRetrieve conversation historyLowNo
CompactSessionCompact long conversation contextLowNo
SkillLoad or invoke a skillDependsDepends

Automation

ToolFunctionRiskConfirmation
CreateScheduleCreate delay, at, interval, or cron schedulesMediumYes
HeartbeatRespondSubmit heartbeat outcome, notifications, and file linksLowNo
WorkflowCreateCreate workflow definitionsMediumUsually
WorkflowValidate / WorkflowTestValidate or test workflow definitionsLowNo
WorkflowRunRun workflowsMediumUsually
WorkflowViewOpen the workflow canvas for inspectionLowNo

Documents and Media

ToolFunctionRiskConfirmation
ExportDocumentExport PDF, DOCX, or related formatsLow-MediumDepends
GenerateImageGenerate or edit imagesMediumDepends on provider/cost
GenerateVideoGenerate videosMediumDepends on provider/cost
BeautifyImageImprove, crop, center, or optimize imagesMediumDepends
UnderstandImageUse a vision providerLow-MediumDepends
MathCalcDeterministic high-precision calculationLowNo

Media generation tools require a configured image_gen, video_gen, or image processing provider. See Media Generation.

MCP Resources

ToolFunctionRiskConfirmation
McpListResources / McpReadResourceList and read MCP resourcesLowNo
McpListPrompts / McpGetPromptList and expand MCP promptsLowNo

MCP tools come from connected external services. Their permissions, risks, and approval behavior depend on the service declaration and DesireCore local permission policy.