Tools

Tools are how Caretz acts: it reads and edits files, runs commands, searches the web, and calls anything else you register. You can narrow the set for one run:

caretz --tools Read,Grep,Find,Ls -p "explain the request flow"
caretz --disable-tool Bash -p "review this diff without running anything"

Built-in Tools

Tool	What it does	Available
`Read`, `Edit`, `Write`	Read and change files in the workspace	Always
`Ls`, `Find`, `Grep`	List, find, and search files	Always
`Bash`	Run commands in the sandbox	Always
`UpdateTasks`, `ListTasks`	Track multi-step work	Unless `--no-tasks`
`CallSubagent`	Hand a job to a subagent	Always
`WebFetch`	Read a public web page	Always
`WebSearch`	Search the web	With an API key, see Web search and fetch
`LocalImage`	Describe an image with a local vision model	When configured
`SendFile`	Send a workspace file to the user	In ACP editors and apps that support it

Interactive sessions also get RegisterSchedule, UpdateSchedule, ListSchedules, and RemoveSchedule for schedules .

Tool names are case-insensitive in --tools and --disable-tool. To keep the same set every time, put tools or disabledTools in a profile .

Add Your Own

Add tools to the CLI : ship your own caretz binary with extra tools.
Add tools to your Go app : register tools when embedding the agent.

In this section

Web search and fetchLet caretz look things up and read documentation pages. Analyze images locallyLet a text-only model read screenshots through a vision model. Add tools to the CLIBuild your own caretz binary with extra tools. Add tools to your Go appRegister your own tools when embedding the agent.