Read a file from a configured workspace root, usually a companion repo outside the current project workspace. Prefer the IDE built-in read/navigation tools for files in the current workspace. Returns up to 500 lines by default with line numbers and metadata (totalLines, range, truncated); use offset/limit to paginate.

Create or overwrite a file in a configured workspace root, typically another repo exposed through this MCP rather than the current project. Prefer built-in IDE editing/refactoring tools for current-workspace files. If a writeAllowlist is configured, only matching paths are writable. All writes are logged.

Apply search-and-replace edits to one or more files in a configured workspace root, typically for companion repos outside the current project workspace. Prefer built-in IDE refactoring/editing tools for typed changes in the current workspace. The same find/replace runs on all specified files; oldString must be unique per file unless replaceAll is true. If a writeAllowlist is configured, only matching paths are editable. When useRegex=true, newString supports regex backreferences ($1, $2, etc.).

List files and directories in a configured workspace root, usually an external or companion repo rather than the current project workspace. Returns metadata (type, size, modified date) and supports recursive tree listing.

Search text or regex in a configured workspace root, usually a companion repo outside the current project workspace. Prefer built-in code navigation/LSP tools in the current workspace when they apply. Uses ripgrep with output modes, context lines, case-insensitive matching, and pagination; when using contextLines, results include contextBefore/contextAfter arrays.

Run a shell command in a configured workspace root, typically a companion repo outside the current project workspace. Supports pipes, redirects, and chained commands. Returns stdout, stderr, and exit code. Use for build tools, codegen, git operations, or any command that needs to run in the workspace directory.