Skip to main content

What are tools?

Tools are discrete capabilities that Claude invokes automatically while working on your task. When you give Claude a coding task it may read source files, run a build command, search for relevant code, and edit files — all via tools — without you having to issue each operation manually. Each tool has:
  • A name — a stable string identifier (e.g. Bash, Read, WebFetch)
  • A description — plain-language explanation of what the tool does, used by Claude to decide when to invoke it
  • A typed input schema — a JSON Schema defining every parameter, its type, whether it’s required, and any constraints
Claude selects which tool to call based on your task description and the current conversation context. It composes tool calls, waits for results, and continues reasoning — repeating until the task is complete or a turn limit is reached.

Permission prompts

Tools that have side effects (writing files, executing shell commands, fetching URLs) require your explicit permission before running. Claurst displays a prompt showing exactly what the tool is about to do; you can allow it once, allow it permanently for that tool/path, or deny it. Read-only tools (file reads, glob/grep searches) are allowed automatically in Default mode.
Permission modeBehavior
DefaultRead-only operations auto-approved; write/execute operations prompt you
AcceptEditsFile writes auto-approved; shell execution still prompts
BypassPermissionsAll operations auto-approved (use with caution)
PlanOnly read-only operations are permitted
BypassPermissions mode skips all confirmation prompts. Only use it in trusted, isolated environments.

How Claude discovers tools

The full tool list is large. To keep the initial prompt lean, most tools are deferred — hidden from the first request. Claude uses ToolSearch to discover deferred tools by keyword when it needs one. Tools marked alwaysLoad are always included in the initial context.

Complete tool reference

File tools

ToolDescription
ReadRead file contents with optional line offset and limit
WriteCreate or overwrite a file
EditExact string replacement inside an existing file
GlobFind files by name pattern, sorted by modification time
GrepSearch file contents by regular expression (backed by ripgrep)
NotebookEditEdit cells in a Jupyter .ipynb notebook

Shell execution tools

ToolDescription
BashExecute shell commands with optional timeout and sandboxing
PowerShellWindows PowerShell execution (mirrors Bash interface)

Web tools

ToolDescription
WebFetchFetch a URL and convert HTML to Markdown
WebSearchSearch the web; returns titles, URLs, and snippets

Agent & multi-agent tools

ToolDescription
AgentSpawn a sub-agent with its own prompt and tool set (lives in cc-query)
SendMessageSend a message to a named agent, broadcast (*), or a bridge session

Task management tools

ToolDescription
TaskCreateCreate a tracked background task with a subject and description
TaskGetRetrieve a task’s status and details by ID
TaskUpdateUpdate a task’s status, description, or dependency links
TaskListList all non-deleted tasks
TaskStopStop a running task (sets status to Failed)
TaskOutputAppend output text to a task
TodoWriteReplace the entire todo list atomically (legacy V1)

MCP integration tools

ToolDescription
mcp__<server>__<tool>Invoke a tool provided by a connected MCP server
mcp__<server>__authenticateAuthenticate with an MCP server via OAuth
mcp__listResourcesList resources available from connected MCP servers
ReadMcpResourceRead the contents of an MCP resource by URI

Plan mode tools

ToolDescription
EnterPlanModeSwitch to read-only planning mode
ExitPlanModeExit plan mode and optionally pre-approve specific commands

Scheduling tools

ToolDescription
CronCreateSchedule a prompt to run on a cron expression
CronDeleteCancel a scheduled job by ID
CronListList all scheduled jobs

Worktree tools

ToolDescription
EnterWorktreeCreate and switch to a git worktree for isolated work
ExitWorktreeReturn from a worktree, keeping or removing it

Meta & discovery tools

ToolDescription
ToolSearchDiscover available tools by keyword or exact name lookup
AskUserQuestionPrompt you for input during task execution
SkillInvoke a user-defined skill (slash command macro)
BriefUpload a file or message to the bridge session (KAIROS mode)
SleepWait asynchronously without holding a shell process

Explore by category

File tools

Read, write, edit, search, and manipulate files and notebooks.

Shell & web tools

Execute shell commands, fetch URLs, and search the web.

Agent & task tools

Spawn sub-agents, manage background tasks, schedule cron jobs, and coordinate agent swarms.

Build docs developers (and LLMs) love