Skip to main content
Dari ships with a fixed set of built-in tools that run inside the session sandbox. Select them from your dari.yml tools: block by name (no path).
tools:
  - name: read
  - name: bash
  - name: edit
  - name: write
  - name: grep
  - name: find
  - name: 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 entries entirely, the agent gets the default set: read, bash, edit, write.

Notes

  • Built-ins always execute in the session sandbox — kind is ignored.
  • Unknown names fail publish with an error listing the valid set.
  • Duplicate entries collapse; the first occurrence wins.
  • Entries with a path are treated as custom tool overrides, not built-in selections.