List allowed workspace roots. Call first — all other tools are scoped to these directories.

List immediate directory contents (non-recursive): name, path, type, size, modified date. Omit path for workspace root. includeIgnored=true for node_modules etc. For recursive search, use find.

Find files by glob pattern (e.g. **/*.ts). Returns matching files with metadata. For content search, use grep. For bulk edits, pass the same glob to search_and_replace.

Render a directory tree (bounded recursion). Returns ASCII tree + structured JSON. maxDepth=0 returns only the root node.

Read text file contents. Use head to preview first N lines of large files. For multiple files, use read_many.

Read multiple text files in one request with contents and metadata. For a single file, use read.

Get file/directory metadata: size, modified, permissions, mime, tokenEstimate. Use tokenEstimate (size÷4) to pre-screen token cost before reading.

Get metadata for multiple files/directories in one request. Use tokenEstimate (size÷4) to pre-screen token cost before reading.

Search file contents for text (grep-like). Returns matching lines. Scope with filePattern (e.g. **/*.ts) to reduce noise. includeHidden=true for dotfiles.

Create a new directory at the specified path (recursive).

Write content to a file, OVERWRITING ALL existing content. Creates the file and parent directories if needed.

Apply sequential literal string replacements to a file (first occurrence per edit). oldText must match exactly — include 3–5 lines of context for unique targeting. Use dryRun:true to preview.

Move or rename a file or directory.

Permanently delete a file or directory. This action is irreversible.

Calculate SHA-256 hash of a file or directory.

Generate a unified diff between two files. Output feeds directly into apply_patch. isIdentical=true means files match — no patch needed.

Apply a unified diff patch to one or more files. Single-file: throws on failure. Multi-file: best-effort per file with results[]. Workflow: diff_files → apply_patch(dryRun:true) → apply_patch. On failure, regenerate the patch from current file content.

Bulk search-and-replace across files matching a glob. Replaces ALL occurrences per file (unlike edit: first only). Always dryRun:true first — returns a unified diff. Literal matching by default; isRegex:true enables RE2 with capture groups ($1, $2).