참고: 이 프로젝트는 Switch2Cursor를 수정하여, Cursor 전용 지원에서 Cursor, Qoder, Claude code 등을 포함한 포괄적인 AI 에이전트 협업으로 확장되었습니다.

💡 Cursor에서 Switch2IDEA와 함께 사용하는 것을 권장합니다

switch2ai - JetBrains IDE와 다양한 AI 에이전트(Cursor, Qoder, Claude code 등) 간의 원활한 협업을 가능하게 하는 JetBrains IDE 플러그인입니다. 주요 기능으로는 서로 다른 AI 에디터 간의 즉각적인 전환, AI 선택 기능을 통한 신속한 AI 프롬프트 (Prompt) 입력, 그리고 향상된 AI 협업 워크플로우를 위한 변수 지원 및 완전 설정 가능한 커스텀 명령 (Custom commands) 등이 있습니다.

🚀

즉각적인 AI 에디터 전환 (Instant AI Editor Switching)

• JetBrains IDE와 다양한 AI 에디터(Cursor, Qoder, Claude code 등) 간의 원클릭 전환

• 동일한 커서 위치(행 및 열)로 자동 이동

• 워크플로우를 방해하지 않고 편집 컨텍스트 (Context)를 완벽하게 유지

⌨️

편리한 단축키 지원 (Convenient Shortcut Support)

• macOS:
  Option+Shift+K

• AI 프롬프트 입력 팝업 열기 Option+Shift+P

• Cursor 에디터에서 프로젝트 열기 Option+Shift+O

• Cursor 에디터에서 현재 파일 열기 Option+Shift+U

• Qoder에서 현재 파일 열기 Option+Shift+I

• Qoder에서 프로젝트 열기

• Windows:
  Alt+Shift+K

• AI 프롬프트 입력 팝업 열기 Option+Shift+P

• Cursor 에디터에서 프로젝트 열기 Option+Shift+O

• Cursor 에디터에서 현재 파일 열기 Alt+Shift+U

• Qoder에서 현재 파일 열기 Alt+Shift+I

• Qoder에서 프로젝트 열기

• macOS:

🤖

신속한 AI 프롬프트 입력 (Rapid AI Prompt Input)

• AI 선택 드롭다운을 통한 빠른 AI 프롬프트 입력

• 여러 AI 에이전트(Cursor, Qoder, Claude code 등) 지원

• 지능적인 컨텍스트 인식 프롬프트 처리

• 다음과 같은 단축 명령 지원:
  $test
  , $refactor
  , $explain

🔧

다양한 접근 방식 (Multiple Access Methods)

• 키보드 단축키

• 에디터 컨텍스트 메뉴 (Context menu)

• IDE 도구 메뉴

⚡

완전 설정 가능한 커스텀 명령 (Fully Configurable Custom Commands)

• 포괄적인 변수 지원을 통한 커스텀 명령 실행

• 변수:
  $filePath
  , $projectPath
  , $line
  , $column
  , $selectedText
  , $prompt

• $test와 같은 단축 명령 지원

,$refactor

,$explain`

• 완전히 커스터마이징 가능한 명령 템플릿 (Command templates)

• 동적 명령 등록 및 관리 (Dynamic command registration and management)

• 플러그인이 이제 공식 JetBrains Marketplace에서 사용 가능합니다

• IDE에서 직접 원클릭 설치

• 자동 업데이트
  IDE의 플러그인 마켓플레이스에서 "switch2ai"를 검색하세요

Releases 페이지에서 최신 플러그인 패키지를 다운로드하세요. JetBrains IDE를 실행한 후

Settings (Windows/Linux) 또는 Preferences (macOS) 로 이동하세요.

Plugins

→ ⚙️

→ Install Plugin from Disk...

다운로드한 .zip 파일을 선택하세요.

OK를 클릭하여 변경 사항을 적용하세요.

알림이 뜨면 IDE를 재시작하세요.

# 리포지토리 클론 (Clone repository)
git clone https://github.com/sinberCS/switch2ai.git
# 플러그인 빌드 (Build plugin)
...

• 단축키 (Shortcuts):

• macOS:
  Option+Shift+O (파일), Option+Shift+P (프로젝트)

• Windows:
  Alt+Shift+O (파일), Alt+Shift+P (프로젝트)

• macOS:

• 컨텍스트 메뉴 (Context Menu): 프로젝트 뷰에서 우클릭 → Open Project In Cursor Editor

• 도구 메뉴 (Tools Menu): Tools → Open Project In Cursor Editor

• 단축키 (Shortcuts):

• macOS:
  Option+Shift+U (파일), Option+Shift+I (프로젝트)

• Windows:
  Alt+Shift+U (파일), Alt+Shift+I (프로젝트)

• macOS:

• 컨텍스트 메뉴 (Context Menu): 에디터에서 우클릭 → Open In Qoder

• 도구 메뉴 (Tools Menu): Tools → Open In Qoder

• 단축키 (Shortcuts):

• macOS:
  Option+Shift+K

• Windows:
  Alt+Shift+K

• macOS:

• 컨텍스트 메뉴 (Context Menu): 에디터에서 우클릭 → AI Prompt Input

• 도구 메뉴 (Tools Menu): Tools → AI Prompt Input

• 기능 (Features):

• 드롭다운에서 AI 에이전트 선택 (Cursor, Qoder, Claude code 등)

• 지능적인 문맥 인식 (Context awareness)을 통한 프롬프트 입력

• $test, $refactor, $explain과 같은 단축 명령 지원

• 빠른 접근을 위해 커서 위치에 팝업 표시

Settings/Preferences → Tools → switch2ai 에서:

AI Configuration 탭: AI 에이전트 (Cursor, Qoder, Claude code 등) 설정

• AI 에이전트 이름, 표시 이름, 명령 템플릿 및 설명 설정
• 변수 지원 기능이 포함된 명령 템플릿 구성

사용자 정의 명령 (Custom Commands) 탭: 포괄적인 변수 지원을 통해 사용자 정의 명령을 구성합니다.

• 명령 ID, 단축키, 명령 템플릿 및 설명 설정
• 변수 지원:
  $filePath
  , $projectPath
  , $line
  , $column
  , $selectedText

단축키 충돌 확인 (Check Shortcut Conflicts): 키보드 단축키 충돌을 감지하고 해결합니다.

단축키 명령 (Shortcut Commands) 탭: $test, $refactor, $explain과 같은 단축키 명령을 설정합니다.

• 전체 프롬프트로 확장되는 짧은 명령을 정의합니다.
• 예시:
  $test
  는 "이 함수에 대한 단위 테스트를 작성해 주세요..."로 확장됩니다.
• Keymap 설정을 통해 단축키를 사용자 정의할 수 있습니다.

자동 감지 (Automatic Detection): 플러그인은 등록 과정에서 단축키 충돌을 자동으로 감지합니다.
사용자 선택 대화 상자 (User Choice Dialog): 충돌하는 단축키를 교체할지 묻는 대화 상자를 표시합니다.
충돌 제거 (Conflict Removal): 사용자가 교체를 선택하면 충돌하는 단축키가 먼저 제거됩니다.
수동 확인 (Manual Check): 설정에서 "Check Shortcut Conflicts" 버튼을 사용하여 충돌을 스캔할 수 있습니다.
해결 (Resolution): Settings
→ Keymap
에서 단축키를 다시 할당하여 충돌을 해결할 수 있습니다.

플러그인에는 다음 항목들이 사전 구성되어 제공됩니다:

AI 에이전트 (AI Agents): Claude Code, iflow
단축키 명령 (Shortcut Commands): $test, $refactor, $explain, $optimize, $debug, $doc
사용자 정의 명령 (Custom Commands): 파일 및 프로젝트 지원을 통해 Cursor/Qoder로 이동

• 설치된 모든 AI 에디터 (Cursor, Qoder, Claude code 등)
• 모든 JetBrains IDE와 호환 (버전 2022.3 이상)
• 통합 터미널 실행을 위해 터미널 플러그인이 활성화되어 있어야 함

최신 릴리스 (Latest Release): switch2ai-0.1.2.zip
모든 릴리스 (All Releases): Releases Page
호환성 (Compatibility): JetBrains IDEs 2022.3+

src/main/kotlin/com/github/switch2ai/
├── actions/
│   ├── processor/ # 명령 실행 로직
...

# 저장소 클론 (Clone repository)
git clone https://github.com/sinberCS/switch2ai.git
# 플러그인 빌드 (Build plugin)
...

DynamicActionRegistry: 커스텀 명령(custom commands) 및 액션(actions)의 동적 등록을 관리합니다.
CommandProcessor: 명령 실행 및 AI 프롬프트(prompt) 처리를 담당합니다.
AppSettingsConfigurable: 포괄적인 설정 인터페이스를 제공합니다.
PromptInputPopup: 커서 위치에 빠른 프롬프트 입력 팝업을 띄웁니다.
ShortcutCommandReplacer: 단축 명령 확장(shortcut command expansions)을 처리합니다.

• 이 저장소(repository)를 포크(Fork)하세요
• 기능 브랜치(feature branch)를 생성하세요
• 변경 사항을 커밋(Commit)하세요
• 브랜치에 푸시(Push)하세요
• 풀 리퀘스트(Pull Request)를 제출하세요

다음 제품을 포함한 모든 JetBrains IDE를 지원합니다: IntelliJ IDEA, PyCharm, WebStorm, GoLand, RustRover, Android Studio 등.

이 플러그인은 JDK 17을 기반으로 개발되었으며, 현재 JetBrains IDE 버전 2022.3 이상만 지원합니다.

Settings에서 수정

→ Keymap

→ Plugins

→ switch2ai

Settings로 이동

→ Tools

→ switch2ai

하여 변수(variable) 지원 기능이 포함된 커스텀 명령을 설정하세요.

$test와 같은 단축 명령(shortcut commands)은 AI 프롬프트 입력창에 입력할 때 자동으로 전체 프롬프트로 확장됩니다.

네, AI 설정(AI Configuration) 탭에서 커스텀 명령 템플릿(command templates)과 변수 지원 기능을 갖춘 커스텀 AI 에이전트(AI agents)를 추가할 수 있습니다.

플러그인은 현재 파일 경로, 줄(line), 열(column)을 자동으로 캡처한 다음, 정확한 위치 지정을 위해 이 정보를 AI 에디터(AI editors)에 전달합니다.