Browse

Grant a pending approval token. Use when the user has explicitly approved the requested exception.

List all approval tokens, their statuses, and scopes.

Request a one-time permission exception from the user. Use when a tool call is blocked by permission mode and you need user approval. Returns a token ID.

Revoke a previously granted approval token.

Execute a bash shell command and return its output. Use for running scripts, checking system state (git status, ls, etc.), or performing file operations. Press Ctrl+C to interrupt (partial output returned to LLM); press Ctrl+Z to background (use bash_job_wait to retrieve output).

List background bash jobs started with bash_exec and backgrounded via Ctrl+Z. Shows job ID, status (running/done/failed), command, and elapsed time.

Wait for a background bash job (from bash_exec backgrounded via Ctrl+Z) to complete and return its full output. Use the job_id from the bash_exec backgrounded result.

Evaluate a mathematical expression and return the result. Accepts any valid numeric expression (e.g. '2 + 2', '3.14 * 10**2', 'sqrt(16)'). Powered by Starlark math evaluation.

Find the definition of a symbol using semantic analysis (LSP). Returns file and line. Requires: symbol, path.

Get compiler/linter diagnostics for a file. Returns errors, warnings, hints. Requires: path.

Graph everything in the index: the full reference graph plus every root file (files nothing else references). Requires an index built with code_index_folder first.

Graph a single indexed file: its reference tree plus every other indexed file that shares a topic with it. Requires an index built with code_index_folder first. Requires: path.

Graph every indexed file tagged with a topic, plus the full reference graph. Requires an index built with code_index_folder first. Requires: topic.

Get documentation and type info for a symbol. Returns doc comments and type signatures. Requires: symbol, path.

Index the current working directory into a persistent graph database, tracking markdown/wikilink references between files and topics/tags declared in YAML frontmatter. Always indexes the CWD -- cannot be pointed at another directory. Run this once before code_graph_file, code_graph_topic, or code_graph_all.

Find all references to a symbol across the codebase. Returns every file and line. Requires: symbol, path.

Search for a symbol or pattern across the codebase. Use this first to locate symbols before using code_definition or code_references. Requires: query, path.

List all symbols (functions, types, classes) in a file. Returns structured symbol info with nesting. Requires: path.

Rerank a list of documents by relevance to a query using Cohere's reranking API. Returns documents sorted by relevance score. Requires COHERE_API_KEY.

Create a new scheduled cron job. The job will fire at the given cron expression and create a task each time it fires. Returns the cron ID.

Delete a cron job. Marked as deleted in the registry.

List all cron jobs in the registry. Shows expression, status, and last/next run times.

Pause a cron job. No new tasks will be created until resumed.

Resume a paused cron job.

Edit a file. Pass command:

Search for documents semantically similar to a query in the local embedding database. Returns ranked results with similarity scores. Requires: query (natural language search query), collection (name of the document collection). Optional: limit (max results, default 5).

Convert text into vector embeddings using an embedding model. Returns the embedding vectors. Use for indexing documents into the local embedding database or computing semantic similarity. Requires: texts (list of strings to embed). Optional: model, backend.

Search the web using Exa (formerly Metaphor) neural search. Finds highly relevant URLs and content using AI-powered link prediction. Best for research, finding authoritative sources, and content discovery. Requires EXA_API_KEY.

Mark the ACTIVE task finished and advance to the next one. Call this as soon as the active task's objective is met. Pass the active task's id and a one-line summary of what was achieved.

Give up on the ACTIVE task and advance to the next one. Use this instead of retrying when the task cannot be completed, so the goal keeps moving. Pass the active task's id and the reason.