Tool definitions
These 27 built-in tool definitions account for 29,645 tokens in the captured request.
- Workflow
Execute a workflow script that orchestrates multiple subagents deterministically. Workflows run in the background — this tool returns immediately with a task ID, and a <task-notification> arrives when the workflow…
Estimate: ~7,608 tokens - Monitor
Start a background monitor that streams events from a long-running script. Each stdout line is an event — you keep working and notifications arrive in the chat. Events arrive on their own schedule and are not replies…
Estimate: ~2,394 tokens - EnterPlanMode
Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you…
Estimate: ~1,608 tokens - CronCreate
Schedule a prompt to be enqueued at a future time. Use for both recurring schedules and one-shot reminders. Uses standard 5-field cron in the user's local timezone: minute hour day-of-month month day-of-week. "0 9 * * *"…
Estimate: ~1,519 tokens - AskUserQuestion
Use this tool only when you are blocked on a decision that is genuinely the user's to make: one you cannot resolve from the request, the code, or sensible defaults. Usage notes: Users will always be able to select…
Estimate: ~1,411 tokens - ScheduleWakeup
Schedule when to resume work in /loop dynamic mode — the user invoked /loop without an interval, asking you to self-pace iterations of a specific task. Do NOT schedule a short-interval wakeup to poll for background work…
Estimate: ~1,392 tokens - TaskUpdate
Use this tool to update a task in the task list. When to Use This Tool Mark tasks as resolved: When you have completed the work described in a task When a task is no longer needed or has been superseded IMPORTANT: Always…
Estimate: ~1,375 tokens - EnterWorktree
Use this tool ONLY when explicitly instructed to work in a worktree — either by the user directly, or by project instructions (CLAUDE.md / memory). This tool creates an isolated git worktree and switches the current…
Estimate: ~1,301 tokens - Agent
Launch a new agent to handle complex, multi-step tasks. Each agent type has specific capabilities and tools available to it. Available agent types and the tools they have access to: claude: Catch-all for any task that…
Estimate: ~1,263 tokens - Bash
Executes a bash command and returns its output. Working directory persists between calls, but prefer absolute paths — cd in a compound command can trigger a permission prompt. Shell state (env vars, functions) does not…
Estimate: ~1,034 tokens - TaskCreate
Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user. It also helps the user understand the…
Estimate: ~978 tokens - ExitWorktree
Exit a worktree session created by EnterWorktree and return the session to the original working directory. Scope This tool ONLY operates on worktrees created by EnterWorktree in this session. It will NOT touch: Worktrees…
Estimate: ~898 tokens - ExitPlanMode
Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval. How This Tool Works You should have already written your plan to the plan file specified in…
Estimate: ~884 tokens - NotebookEdit
Replaces, inserts, or deletes a single cell in a Jupyter notebook (.ipynb file). Usage: You must use the Read tool on the notebook in this conversation before editing — this tool will fail otherwise. notebook_path must…
Estimate: ~607 tokens - Skill
Execute a skill within the main conversation When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge. When users reference a "slash…
Estimate: ~604 tokens - Read
Reads a file from the local filesystem. file_path must be an absolute path. Reads up to 2000 lines by default. When you already know which part of the file you need, only read that part. This can be important for larger…
Estimate: ~587 tokens - TaskOutput
DEPRECATED: Background tasks return their output file path in the tool result, and you receive a <task-notification> with the same path when the task completes. For bash tasks: prefer using the Read tool on that output…
Estimate: ~523 tokens - PushNotification
This tool sends a desktop notification in the user's terminal. If Remote Control is connected, it also pushes to their phone. Either way, it pulls their attention from whatever they're doing — a meeting, another task,…
Estimate: ~500 tokens - TaskList
Use this tool to list all tasks in the task list. When to Use This Tool To see what tasks are available to work on (status: 'pending', no owner, not blocked) To check overall progress on the project To find tasks that…
Estimate: ~436 tokens - TaskGet
Use this tool to retrieve a task by its ID from the task list. When to Use This Tool When you need the full description and context before starting work on a task To understand task dependencies (what it blocks, what…
Estimate: ~380 tokens - Edit
Performs exact string replacement in a file. You must Read the file in this conversation before editing, or the call will fail. old_string must match the file exactly, including indentation, and be unique — the edit…
Estimate: ~329 tokens - WebSearch
Search the web. Returns result blocks with titles and URLs. US-only. The current month is June 2026 — use this when searching for recent information. allowed_domains / blocked_domains filter results. After answering from…
Estimate: ~292 tokens - WebFetch
Fetches a URL, converts the page to markdown, and answers prompt against it using a small fast model. Fails on authenticated/private URLs — use an authenticated MCP tool or gh for those instead. HTTP is upgraded to…
Estimate: ~283 tokens - Write
Writes a file to the local filesystem, overwriting if one exists. When to use: creating a new file, or fully replacing one you've already Read. Overwriting an existing file you haven't Read will fail. For partial…
Estimate: ~222 tokens - TaskStop
Stops a running background task by its ID Takes a task_id parameter identifying the task to stop Returns a success or failure status Use this tool when you need to terminate a long-running task
Estimate: ~197 tokens - CronDelete
Cancel a cron job previously scheduled with CronCreate. Removes it from the in-memory session store.
Estimate: ~140 tokens - CronList
List all cron jobs scheduled via CronCreate in this session.
Estimate: ~90 tokens
Per-item estimates are independent comparisons and do not sum to the total.