Open a file in the editor and optionally select a range of text

Open a diff view comparing old file content with new file content. Creates temporary files on disk.

Write HTML to temp file and open in default browser. For visual reports and dashboards.

Open files/tabs with isDirty, isActive when ext connected. Fallback: session-opened files only.

Get all workspace folders currently open in the IDE

Architectural overview via codebase-memory graph: module boundaries, dependencies, ADRs, hotspot files. Returns structured query plan. Requires codebase-memory connected.

Project overview: name/version, languages, pkg manager, scripts, deps, config, git. Call at session start.

Get the current text selection in the editor

Get the most recent text selection (even if not in the active editor)

Errors/warnings from TS, ESLint, Pyright, Ruff, Cargo, Go vet, Biome. Real-time LSP when ext connected.

Check if file has unsaved changes. Uses VS Code buffer when ext connected; heuristic otherwise.

Save workspace document via VS Code buffer when ext connected. No-op otherwise (editText writes to disk).

Close editor tab by file path. Prompts to save if dirty. Requires ext.

Close all diff tabs and clean up temp diff directories.

Available CLI tools, ext connection state, and which features are functional vs stub-only.

Health check: extension, git, linters, test runners, GitHub CLI. Use when tools misbehave.

Search workspace files via ripgrep. Returns matching lines with file paths and line numbers.

Find and replace across workspace files. Supports regex with capture groups. Returns modified files.

Find files by name/glob pattern in the workspace. Respects .gitignore.

Workspace file tree. Respects .gitignore. Skips node_modules, .git, dist, build, coverage.

Git status: branch, staged/unstaged/untracked files, ahead/behind counts.

Get the git diff output for the workspace or a specific file

Get recent git log entries for the workspace or a specific file

Full commit details: author, date, message, changed files, optional diff patch.

Diff between two git refs (branches/tags/commits). statOnly for file-level summary only.

Stage files for commit. Omit to stage all tracked (git add -u). addUntracked:true for new files.

Commit staged changes. Pass files to stage-and-commit in one step. Returns hash, branch, files.

Switch to a branch, or create and switch to a new branch. Use create: true to create from HEAD or a specified base.

Per-line last modifier and commit. Trace why code was written or find the introducing commit.

Fetch updates from a remote without merging. Updates remote-tracking branches so gitListBranches and gitCheckout see the latest state. Use gitPull to fetch and merge in one step.

List git branches. Returns local branches with the current branch marked. Pass includeRemote: true for remote-tracking branches.

Pull changes from a remote into the current branch. Defaults to origin with merge. Use rebase: true for linear history.

Push the current branch to a remote. Use setUpstream: true on the first push. Force push uses --force-with-lease. Blocked on main/master.

Stash current changes to get a clean working tree. Required before switching branches with uncommitted changes. Use gitStashPop to restore. Pass includeUntracked: true to also stash new files.

Restore stashed changes to the working tree. Pops the most recent stash by default, or a specific entry by index (from gitStashList).

List all stash entries in the repository. Returns each entry's index, branch it was stashed from, message, and age. Use before gitStashPop to identify the right entry to restore.

Execute allowlisted command. Returns stdout, stderr, exit code, timing. No shell for security.

List symbols (fns, classes, interfaces, methods) in a file: names, kinds, lines, parents.

Go to the definition of a symbol at a given position using VS Code LSP.

Find all references to a symbol at a given position using VS Code LSP.

Find implementations of interface, abstract method, or abstract class.

Go to the type definition of a symbol. Unlike goToDefinition (navigates to declaration), this navigates to where the type itself is defined.

Go to the declaration of a symbol (header file in C/C++, .d.ts entry in TypeScript). Unlike goToDefinition, navigates to the 'declare' statement rather than the implementation.

Get hover information (type info, documentation) for a symbol at a given position.

Get available code actions (quick fixes, refactorings) for a range in a file.

Apply code action by title. Use getCodeActions first to see options.

Preview edits a code action would make without applying. Use before applyCodeAction.

Preview refactoring edits across files without applying. Use getCodeActions first.

Rename symbol across all files via LSP. Returns affected files and edit counts.

Search workspace symbols (classes, fns, vars, interfaces) by name via LSP.

Get the call hierarchy for a function or method. Use direction="incoming" to find callers, "outgoing" to see everything it calls, or "both" (default).

Get comprehensive symbol info in one call: type signature, docs, definition location, call hierarchy, and reference count.

Check if symbol can be renamed. Returns canRename:false with reason if not. Use before renameSymbol.

Format a line range via LSP formatter. Faster than full formatDocument for large files.

Function signature and param info at a call site. Returns active sig, param index, overloads.

Refactor impact: rename safety, ref/caller counts, risk level (low/medium/high). Use before renameSymbol.

Foldable regions in a file (functions, classes, imports, comments). Returns {startLine, endLine, kind}.

Hierarchical selection ranges at position: identifier→expression→block→function→class.

Collect IDE context in one call: active file, diagnostics, diff, editors, handoff note, git status.

Create .claude-plan.md in workspace root. Markdown with sections and task checklists.

Update plan file: mark tasks done/undone, add tasks or sections.

Read plan file. Returns title, sections, tasks, and completion status.

Delete a plan file from the workspace root.

List all plan files in the workspace root. Returns filenames with titles from frontmatter.

Run tests (Vitest/Jest/Pytest/Cargo/Go). Returns pass/fail, failures, file:line. Cached 30s.

Query recent tool call log: names, timing, status, percentiles, co-occurrence.

Long-poll for new activity log entries. Pass lastId as sinceId on next call.

IDE bridge status: ext connection, circuit breaker, uptime, tool availability.

Watch glob pattern for file changes (created/modified/deleted). Use unwatchFiles to stop.

Stop watching files for a previously registered watcher by ID.

List active VS Code terminals: names, indices, output capture availability.

Get recent output from a VS Code integrated terminal. Identify by name or index (from listTerminals). Returns last N lines. On headless VPS/SSH, use runInTerminal instead.

Create VS Code integrated terminal. Options: name, cwd, env vars, shell.

Close a VS Code terminal by name or index.

Send text/command to VS Code terminal. Fire-and-forget; use getTerminalOutput to check results.

Execute command and wait for completion. Returns exit code and output. Prefer over runCommand.

Block until regex matches terminal output. Returns {matched, matchedLine, elapsed} or timedOut.

Create file or directory within workspace. Uses VS Code when connected, native fs fallback.

Delete workspace file or directory. VS Code (with trash) when connected, native fs fallback.

Rename or move workspace file/directory. Uses VS Code when connected, native fs fallback.

Read workspace file from VS Code buffer including unsaved changes. Use before editText. Returns isDirty flag. Workspace files only.

Replace exact text block in a workspace file by content match, no line numbers. Fails clearly if not found or ambiguous.

Insert/delete/replace text at 1-based line/col. Atomic multi-edit. Uses VS Code or native fs. Workspace files only.

Format file via VS Code formatter or CLI fallback (prettier/biome/black/gofmt/rustfmt).

Format a file and save it in one call (formatDocument + saveDocument). Formatter errors propagate; save is not attempted on format failure.

Jump to first workspace error (getDiagnostics→openFile→decoration). Returns {found:false} if none.

Find symbol by name and jump to definition. Replaces searchSymbols→goToDefinition pattern.

Auto-fix lint errors. VS Code source.fixAll when connected, falls back to eslint/biome/ruff.

Organize/sort imports in workspace file. Uses VS Code ext when connected; falls back to Biome or Prettier.

Long-poll for diagnostic changes. Use after edits to wait for LSP re-validation.

Read system clipboard. Returns up to 100 KB of text.

Write text to system clipboard. Max 1 MB.

Retrieve handoff note from prior session (Desktop or CLI). Call at session start to resume.

Save context note that persists across sessions. Use when switching between CLI and Desktop.

Read VS Code workspace settings. Filter by section (e.g. 'editor', 'typescript'). Returns source scope.

Write VS Code workspace setting (dot notation e.g. editor.tabSize). security.* writes blocked.

Capture screenshot → base64 PNG. macOS/Linux with display only. Not available on headless servers.

Execute VS Code command by ID. Use listVSCodeCommands to discover IDs.

List all registered VS Code commands (up to 2000). Filter by substring to find IDs.

List VS Code tasks from tasks.json and extensions. Returns name, type, group, source.

Run VS Code task by name. Waits for completion, returns exit code. For build/test/lint tasks.

Inlay hints (inline type annotations, param names) for a line range. e.g. TS types, Rust lifetimes.

Hover docs for symbol at current cursor. Zero-input wrapper around getHover.

Type signature for symbol at position via LSP hover. Returns clean signature from hover markdown.

Tree of local imports for a file. Useful for understanding deps and finding circular imports.

Resolve imported symbols → type signatures. Use before calling unfamiliar functions.

Get file references and URLs in a document. File links are workspace-relative.

Hover info (type signatures, docs) for up to 10 positions. Prefer over repeated getHover.

Go to definition for up to 10 symbols. Prefer over repeated goToDefinition.

Find implementations for up to 10 symbols. Prefer over repeated findImplementations.

Type hierarchy: supertypes (parents) and subtypes (impls/subclasses). Requires LSP support.

Semantic token types and modifiers for a file from the language server.

Code lens items for a file: ref counts, Run/Debug buttons, impl counts from language server.

Blast radius after editing a file: diagnostics + reference counts for changed symbols.

VS Code debugger state: session info, paused location, call stack, locals. hasActiveSession=false if idle.

Evaluate expression in active debug session. Session must be paused at a breakpoint.

Set breakpoints in a file (replaces existing). Supports conditions, logpoints, hit counts.

Start debug session from .vscode/launch.json. Pass configName to select configuration.

Stop active debug session. No-op if none running.

Place visual decorations (highlights, inline text) on file lines. Grouped by ID; replaces on each call.

Clear editor decorations by ID, or omit id to clear all Claude-managed decorations.

Set active workspace folder for file ops. Useful in multi-root workspaces.

HTTP/HTTPS request → status, headers, body. Body truncated at maxResponseBytes (default 50 KB).

Parse VS Code REST Client file (.http/.rest). Returns method, URL, headers, body per request.

Dependency tree (npm/cargo/go/pip). Auto-detects package manager. Returns names and versions.

Security audit: CVEs with severity and remediation. Auto-detects npm/yarn/pnpm/cargo/pip-audit.

Detect outdated packages (current vs latest). Supports npm, yarn, pnpm, cargo, pip. Complement to getSecurityAdvisories.

Find unused exports, locals, parameters via tsc --noUnusedLocals or ts-prune.

Generate API docs (markdown/JSON) for TS/JS exported symbols. Extracts fns, classes, interfaces, JSDoc.

Extract lines into a named function. Uses VS Code Extract Function when available.

Most frequently changed files in git history. High frequency → active dev or instability.

Symbol evolution: LSP definition + git blame on definition site + file commit history. Answers 'why does this exist?' and 'who changed it last?'

Cached session-start brief: active file, errors, recent commits, modules. Skips cold-start re-exploration.

Token usage estimate for this session: schema size, call counts, largest tool results.

Find tools by keyword/category before tools/list. In --lazy-tools mode, call this first then tools/schema, or set includeSchema:true to return each match's inputSchema inline.

Session analytics: top tools by call count, hook events, recent automation tasks.

Live performance assessment: per-tool latency percentiles, throughput, extension health, session counts, and overall health score.

Spawn claude-ide-bridge for a workspace dir. Returns pid/port/authToken once lock appears; optionally waits for extension handshake.

Preview what editText or searchAndReplace would do as a unified diff, without writing to disk.

Start a new multi-file edit transaction. Returns a transactionId for subsequent stageEdit calls.

Stage a file edit inside a transaction. Supports lineRange and searchReplace operations (same params as previewEdit). Does NOT write to disk.

Write all staged edits atomically. All files are written; on partial failure, written files are NOT rolled back (use rollbackTransaction before commitTransaction to verify).

Discard all staged edits for a transaction without writing anything to disk.

Compute what changed since the handoff note was written: git diff summary + new/resolved diagnostics.

Bundle diagnostic details + code context (±10 lines) + go-to-definition + callers (up to 5) for a file/line/character position.

Find test files that cover a source file via import search + name patterns. Optionally includes coverage pct per test file.

Map a test pattern to covered source lines from lcov.info or coverage-summary.json — no instrumentation needed. Without per-test coverage, returns whole-suite coverage filtered by filename pattern.

Correlate browser state with IDE state: dev server URL, diagnostics, git diff summary, and Playwright steps to capture screenshot.

PR description from commits and diff stats vs base branch. Returns markdown → pass to githubCreatePR.

Enrich commit w/ linked issues. Parses #N / GH-N refs from message, fetches issue state via gh, classifies close vs ref. Missing issues flagged unresolved — not errors.

Map stack-trace frames to introducing commits via git blame. Parses Node/Python/browser traces, filters to in-workspace files, returns per-frame commit + overall top suspect.

Fetch a Sentry issue and enrich its stack trace with git blame. Returns per-frame commit attribution + top suspect commit. Requires Sentry connector connected.

Fetch a Linear issue by identifier or URL. Returns title, description, state, assignee, labels, and priority. Requires Linear connector connected.

Create a new Linear issue. Requires Linear connector connected. Returns the created issue identifier and URL.

Update an existing Linear issue. Pass only the fields you want to change. Requires Linear connector connected.

Add a comment to a Linear issue. Requires Linear connector connected.

Fetch a GitHub issue by URL or owner/repo#number ref. Returns title, body, state, labels, assignees, and author. Requires GitHub connector connected.

Fetch a GitHub pull request by URL or owner/repo#number ref. Returns title, body, state, branches, labels, review decision, and diff stats. Requires GitHub connector connected.

Returns the auth status of all MCP connectors (GitHub, Linear, Sentry). Shows whether each is connected and verified, when the token expires, and whether re-authorization is needed.

Post a message to a Slack channel. Use channel name (e.g. 'general') or channel ID. Optionally reply in a thread by providing threadTs.

List public Slack channels the bot has access to. Returns id, name, member count.

Get the connected Slack workspace name, team ID, and bot user ID. Use to confirm Slack is connected.

Fetch upcoming Google Calendar events. Returns events for the next N days. Requires Google Calendar connector connected.

Unified query over approval / enrichment / recipe-run trails. Filter by traceType, time window, or natural key. Answers 'why did X happen' across sources.

Unified context for issue/PR/commit/error ref. Composes issue + linked commits + related traces. mode:'summary' (default) caps bodies; mode:'full' for untruncated. Prefer over gh/git.

Record a problem+solution trace after resolving a task. Future sessions see it via ctxQueryTraces and the session-start digest. Keep problem + solution to one line each.

Record one durable fact about the user (preference, household, standing context) as subject + predicate + value. Stored at agent trust: auditable, but not something Butler asserts on its own.

Read what Butler currently believes about the user. Returns one value per subject+predicate, already resolved for contradictions and retractions. Filter by subject to narrow.

Retract a fact by its seq (from butlerRecall). Writes a tombstone — the fact stops being believed, and the original row stays in the log so the history remains auditable.

Reverse commit→issue lookup from the persisted enrichment log. Returns commits that referenced the given issue, newest first.

Parse coverage report (lcov/coverage-summary.json/clover.xml) → per-file line/branch/fn %. Does not run tests.

Generate test scaffold from exported fns/classes. Returns describe/it content; does not write file.

Enqueue Claude subprocess task. Returns taskId for getClaudeTaskStatus, or stream=true to block.

Get the status and output of a Claude task enqueued with runClaudeTask.

Cancel a pending or running Claude task.

List your Claude tasks, optionally filtered by status.

Re-run a failed, cancelled, or completed Claude task with same prompt. Returns new taskId.

Launch context-aware Claude task from named preset. Same dispatch path as sidebar + CLI. 5s cooldown per preset.