아래 단계에 따라 TaskMaster AI CLI를 Cursor AI와 연동하세요. 한 번만 설정해 두면, 에디터에서 버튼 클릭만으로 TaskMaster를 호출할 수 있습니다.
1. Cursor 설정 열기
-
Cursor를 실행 후, 좌측 하단의 ⚙️ Settings 아이콘을 클릭(또는
Ctrl + ,/⌘ + ,). -
상단 검색창에
External AI또는AI Providers를 입력해 해당 섹션을 찾습니다.
2. 새 Provider 등록
-
External AI 섹션에서 Add Provider(또는
+ New) 버튼 클릭. -
Provider Type으로 Command-Line Interface (CLI) 선택.
3. TaskMaster CLI 정보 입력
| 설정 항목 | 값 예시 | 설명 |
|---|---|---|
| Name | TaskMaster CLI |
에디터에 표시될 이름 |
| Executable | task-master |
터미널에서 실행할 명령어 (task-master) |
| Arguments | (빈 칸) 또는 ["--model=default"] |
필요시 추가 옵션 (대부분 빈 칸) |
| Work Dir | ${workspaceFolder} |
커맨드가 실행될 기본 경로 |
| Timeout | 60000 |
최대 대기 시간(밀리초 단위) |
팁:
task-master --help로 확인되는 옵션이 있으면,Arguments에 JSON 배열 형태로 넣어 줄 수 있습니다.
4. 연결 테스트 및 저장
-
설정창 하단의 Test Connection 또는 Run Test 버튼을 클릭.
-
터미널 출력창에 TaskMaster의 환영 메시지나 버전 정보가 뜨면 성공!
-
Save 버튼을 눌러 설정 저장.
5. 에디터에서 TaskMaster 사용해 보기
-
코드 블록(혹은 파일 전체)을 드래그하여 선택.
-
나타나는 AI 아이콘(또는 우클릭 메뉴) → Ask External AI 클릭.
-
팝업 리스트에서 TaskMaster CLI 선택.
-
하단 입력창에 자연어 지시 입력 (예:
)하고 Enter.
-
제안된 작업(task list)이나 코드를 Accept 또는 Edit하여 적용.
6. 단축키로 빠르게 호출하기
-
Windows/Linux:
Ctrl+Shift+P→ “Ask External AI” → 선택 -
macOS:
⌘+Shift+P→ “Ask External AI” → 선택
Keybindings 설정에서 “Ask External AI”에 원하는 단축키를 지정할 수도 있습니다.
🎯 워크스페이스별 설정 예시
프로젝트별로 다른 플래그나 워크디렉토리를 쓰려면, 프로젝트 루트에 .cursor/settings.json 파일을 만들고 다음을 추가하세요:
위 설정을 마치면, Cursor AI 내부에서 TaskMaster CLI가 자동으로 호출되어, AI가 제안하는 구체적 작업(Task) 목록을 바로 받아보실 수 있습니다.
연동 후 궁금한 점이나 추가 튜닝이 필요하시면 언제든 말씀해 주세요!