Docs/Tools & Features/Tools

Tools

Dynamo ships with built-in tools for common game development tasks.

File Tools

ToolDescription
read_fileRead file contents with line numbers
write_fileCreate or overwrite files
edit_fileSurgical edits with diff preview
list_filesList directory contents with glob patterns
search_filesSearch file contents with regex

Shell

run_command executes shell commands with:

  • Persistent working directory across calls
  • Configurable timeout (default 2min, max 10min)
  • Background execution with jobs bar
  • Output truncation for large results
  • Shell detection (bash, zsh, fish)
  • `DYNAMO=1` environment variable for scripts to detect

Web Tools

ToolDescription
web_fetchFetch URLs with Readability extraction, caching, markdown conversion
web_searchProvider-native web search for real-time information

Git Tools

ToolDescription
git_statusWorking tree status
git_diffStaged and unstaged changes
git_logCommit history
git_commitCreate commits
gh_pr_createCreate GitHub pull requests
gh_pr_viewView pull request details

Permissions

Tools are categorized by risk level:

LevelBehaviorExamples
SafeAuto-executeread_file, list_files, git_status
WritePrompt once per sessionwrite_file, edit_file
DangerousAlways promptrun_command
BlockedRejected immediatelyrm -rf /, git push --force

Use --permissive (-y) to skip prompts for safe and write tools.

Background Jobs

Run long-running commands in the background:

  • Ctrl+B — open jobs bar
  • Ctrl+K — kill selected job
  • Jobs auto-trigger a model response when they complete