task-master –version 이 으로 설치되었는데, 커서ai와 연동하려면 어떻게 해야하지?




아래 단계에 따라 TaskMaster AI CLICursor AI와 연동하세요. 한 번만 설정해 두면, 에디터에서 버튼 클릭만으로 TaskMaster를 호출할 수 있습니다.


1. Cursor 설정 열기

  1. Cursor를 실행 후, 좌측 하단의 ⚙️ Settings 아이콘을 클릭(또는 Ctrl + , / ⌘ + ,).

  2. 상단 검색창에 External AI 또는 AI Providers를 입력해 해당 섹션을 찾습니다.


2. 새 Provider 등록

  1. External AI 섹션에서 Add Provider(또는 + New) 버튼 클릭.

  2. 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. 연결 테스트 및 저장

  1. 설정창 하단의 Test Connection 또는 Run Test 버튼을 클릭.

  2. 터미널 출력창에 TaskMaster의 환영 메시지나 버전 정보가 뜨면 성공!

  3. Save 버튼을 눌러 설정 저장.


5. 에디터에서 TaskMaster 사용해 보기

  1. 코드 블록(혹은 파일 전체)을 드래그하여 선택.

  2. 나타나는 AI 아이콘(또는 우클릭 메뉴) → Ask External AI 클릭.

  3. 팝업 리스트에서 TaskMaster CLI 선택.

  4. 하단 입력창에 자연어 지시 입력 (예:

    이 파일에서 TODO 주석을 TaskMaster에게 할 일 목록으로 변환해줘

    )하고 Enter.

  5. 제안된 작업(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 파일을 만들고 다음을 추가하세요:

json
{ "externalAI.providers": [ { "name": "TaskMaster CLI", "type": "cli", "cmd": "task-master", "args": [], "cwd": "${workspaceFolder}", "timeout": 60000 } ] }

위 설정을 마치면, Cursor AI 내부에서 TaskMaster CLI가 자동으로 호출되어, AI가 제안하는 구체적 작업(Task) 목록을 바로 받아보실 수 있습니다.

연동 후 궁금한 점이나 추가 튜닝이 필요하시면 언제든 말씀해 주세요!

댓글 남기기