Skip to main content
Dari ships with a fixed set of built-in tools that run inside the session sandbox. Select them from the root dari.yml file’s built_in_tools: block by name.
built_in_tools:
  - read
  - bash
  - edit
  - write
  - grep
  - find
  - ls

Supported Tools

NamePurpose
readRead a file from the session workspace
bashRun a shell command inside the sandbox
editApply a targeted edit to a file
writeCreate or overwrite a file
grepSearch file contents for a pattern
findLocate files by name or path
lsList the contents of a directory

Defaults

If you omit built_in_tools entirely, the agent gets the default set: read, bash, edit, write. If you set built_in_tools: [], the agent gets no built-in tools.

Notes

  • Built-ins always execute in the session sandbox.
  • All supported built-in names are reserved; custom tools cannot use read, bash, edit, write, grep, find, or ls even when built-ins are disabled.
  • Unknown names fail publish with an error listing the valid set.
  • Duplicate entries are ignored.
  • The custom_tools: block is only for Dari-executed tools and external tools.