Skip to content

Built-in tools

Every tool goes through the same text-parsed grammar, whether it’s a built-in or an MCP tool. The permission category determines when a call prompts - see Permission modes.

Tool Category Description
read_file read Read a file’s contents. Reads within cwd never prompt; a path outside cwd or a secret file always does.
write_file write Create or overwrite a file.
edit_file write Exact-match search/replace. Fails closed if the match isn’t unique.
bash execute Run a shell command in cwd (PowerShell on Windows).
grep read Search file contents by regex, recursively. Skips node_modules, .git, dist, and secret files.
glob read Find files by glob pattern. Same skip list as grep.
web_fetch network Fetch a URL and return its text, stripped of HTML.
web_search network Query-based web search - configurable backend, DuckDuckGo by default.
task execute Delegate a sub-task to a nested sub-agent.
exit_plan_mode (read) Only offered in plan mode - presents a plan for approval.
ask_user_question (read) Ask a multiple-choice clarifying question. Unavailable in -p mode.

Every plan the model proposes via exit_plan_mode is saved to ~/.polyglot/plans/<timestamp>-<session-id>.md, whether or not you approve it - a durable record of what was proposed. Not written when the session is ephemeral.