Built-in Tools

Huginn’s agentic loop has access to a suite of built-in tools for autonomous operation.

File Operations

ToolDescription
read_fileRead a file’s contents
write_fileWrite content to a file (with diff preview)
edit_fileApply targeted edits to an existing file
list_dirList directory contents
search_filesSearch file contents with grep-like patterns

Git Tools

ToolDescription
git_logView recent commit history
git_diffShow staged/unstaged diffs
git_statusShow working tree status
git_commitCreate a commit
git_stagerStage specific files

Shell & Testing

ToolDescription
bashExecute shell commands (configurable timeout)
run_testsRun your test suite (e.g. go test ./..., pytest, make test)

Tool Permissions

Control which tools Huginn can use in ~/.huginn/config.json:

{
  "disallowed_tools": ["bash", "git_commit"]
}

Or use an allowlist:

{
  "allowed_tools": ["read_file", "search_files", "write_file"]
}