---
name: jetbrains-coding
description: Use when JetBrains MCP tools are available (mcp__jetbrains__*) - enforces IDE-native workflow with problem checking after file completion, and smart refactoring tools instead of grep/sed
---

# JetBrains IDE-Native Coding

## Overview

When JetBrains MCP tools are available, use them instead of Bash/grep/sed. The IDE provides smarter refactoring, real-time error detection, and code formatting that understands your project.

**Trigger:** MCP tools starting with `mcp__jetbrains__` are available.

## Mandatory Workflow

```
EDIT → FILE COMPLETE → CHECK PROBLEMS → FIX → (repeat until 0 problems)
```

1. **After completing a file:** Call `get_file_problems`
2. **If problems found:** Fix them, check again
3. **Continue until:** 0 errors/warnings

## Tool Preference

| Instead of...           | Use JetBrains Tool                         |
| ----------------------- | ------------------------------------------ |
| `grep`, `rg`, Grep tool | `search_in_files_by_text` or `find_usages` |
| `find`, Glob tool       | `find_files_by_name_keyword`               |
| `cat`, Read tool        | `get_file_text_by_path`                    |
| `sed`, Edit tool        | `replace_text_in_file` (targeted)          |
| `tree`, `ls`            | `list_directory_tree`                      |
| Manual rename + grep    | `rename_refactoring` (updates ALL refs)    |
| `git status`            | `get_project_vcs_status`                   |
| `git log --grep`        | `find_commit_by_message`                   |

**When to use standard tools:** Non-code files, complex shell pipelines, operations without JetBrains equivalent.

## Available Tools (Quick Reference)

### Code Intelligence

| Tool                   | Purpose                                       |
| ---------------------- | --------------------------------------------- |
| `find_usages`          | Find all usages of a symbol across project    |
| `get_symbol_info`      | Get docs, type info, declaration location     |
| `rename_refactoring`   | Smart rename - updates all references         |
| `get_file_problems`    | IDE inspections (errors, warnings) for a file |
| `get_project_problems` | All problems across entire project            |

### File Operations

| Tool                    | Purpose                   |
| ----------------------- | ------------------------- |
| `get_file_text_by_path` | Read file content         |
| `replace_text_in_file`  | Targeted text replacement |
| `create_new_file`       | Create file with content  |
| `open_file_in_editor`   | Open file in IDE          |

### Search

| Tool                         | Purpose                              |
| ---------------------------- | ------------------------------------ |
| `search_in_files_by_text`    | Text search across project (indexed) |
| `search_in_files_by_regex`   | Regex search across project          |
| `find_files_by_name_keyword` | Find files by name substring         |
| `find_files_by_glob`         | Find files by glob pattern           |

### Navigation

| Tool                      | Purpose                     |
| ------------------------- | --------------------------- |
| `list_directory_tree`     | Tree view of directory      |
| `get_all_open_file_paths` | Currently open files in IDE |

### Execution

| Tool                       | Purpose                           |
| -------------------------- | --------------------------------- |
| `execute_terminal_command` | Run shell command in IDE terminal |
| `run_configuration`        | Run IDE run configuration         |
| `get_run_configurations`   | List available run configs        |

### VCS

| Tool                     | Purpose               |
| ------------------------ | --------------------- |
| `get_project_vcs_status` | Git status via IDE    |
| `find_commit_by_message` | Search commit history |
| `get_repositories`       | List VCS roots        |

### Debugging

| Tool                         | Purpose               |
| ---------------------------- | --------------------- |
| `get_debugger_breakpoints`   | List all breakpoints  |
| `toggle_debugger_breakpoint` | Add/remove breakpoint |

## Renaming Files

When renaming files (e.g., `task.service.ts` → `service.ts`):

1. **Check if IDE has file rename:** Some JetBrains MCP versions expose file rename that updates imports automatically
2. **If not available:** Use `git mv` for rename, then update imports with `replace_text_in_file` using `replaceAll: true`
3. **After renaming:** ALWAYS run type-check to catch missed imports

**Key insight:** `rename_refactoring` is for SYMBOLS (classes, functions, variables), not files. For file renames, you need to update import paths separately.

## Common Mistakes

| Mistake                                                | Fix                                                                |
| ------------------------------------------------------ | ------------------------------------------------------------------ |
| Using Grep to find symbol usages                       | Use `find_usages` - understands code structure                     |
| Manual rename + search/replace                         | Use `rename_refactoring` - updates imports, references             |
| Not checking for problems                              | Call `get_file_problems` after completing a file                   |
| Ignoring IDE warnings                                  | Fix ALL problems before moving on                                  |
| Using git mv then manually updating imports one by one | Use `replace_text_in_file` with `replaceAll: true` to batch update |

## projectPath Parameter

Always pass `projectPath` to JetBrains tools:

```
projectPath: "/absolute/path/to/project"
```

This avoids ambiguity when multiple projects are open.