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.