Tools

Pawan has 17 built-in tools plus dynamic MCP tool discovery.

File Tools

ToolDescription
read_fileRead file contents (supports line offset/limit)
write_fileCreate or overwrite a file
edit_filePrecise string replacement (old_string → new_string, supports replace_all)
list_directoryList directory contents with file metadata

Search Tools

ToolDescription
glob_searchFind files by glob pattern (e.g., **/*.rs)
grep_searchSearch file contents by regex pattern

Shell

ToolDescription
bashExecute shell commands with configurable timeout

Git Tools

ToolDescription
git_statusRepository status (staged, unstaged, untracked)
git_diffShow changes (supports staged, file-specific)
git_addStage files for commit
git_commitCreate a commit with message
git_logView commit history (configurable count, format)
git_blameLine-by-line authorship for a file
git_branchList branches, show current branch
git_checkoutSwitch branches, create branches, restore files
git_stashStash operations: push, pop, list, drop, show

Agent

ToolDescription
spawn_agentSpawn a sub-agent for delegated tasks

MCP Tools

Pawan connects to MCP servers configured in pawan.toml:

[mcp.daedra]
command = "daedra"
args = ["serve", "--transport", "stdio", "--quiet"]

MCP tools are namespaced as mcp_<server>_<tool> (e.g., mcp_daedra_search_duckduckgo).

List discovered tools: pawan mcp list