fitchmultz/pi-cursor-sdk

pi-cursor-sdk – Cursor의 LLM을 Pi의 터미널 UI에 연결

이것이 무엇인가

• Cursor SDK 에이전트를 로컬에서 실행하고 Pi 터미널 기반 AI 어시스턴트에 연결하는 오픈 소스 확장 프로그램입니다. Pi 사용자는 Cursor 모델(예: grok-4.6, gpt-5.5)을 선택하고 호출할 수 있으며, Pi 세션 내에서 Cursor의 내장 도구(파일 편집, 셸 명령, MCP 서버)를 사용할 수 있습니다.

중요한 이유

• 두 가지 새로운 AI 개발자 도구를 결합합니다: Cursor(도구 사용 기능을 갖춘 코드 중심 LLM 플랫폼)와 Pi(대화형 AI를 위한 터미널 UI). 사용자는 Pi의 친숙한 명령줄 워크플로우에 머물면서 Cursor의 풍부한 도구 생태계를 얻을 수 있습니다.

주요 기능

• 모델 선택 – pi --model cursor/<model>로 모든 Cursor 모델을 선택; 컨텍스트 창 태그(@1m) 및 속도 모드(:fast, :slow)를 지원합니다.
• 사고 수준 – --thinking 플래그로 Cursor의 "사고" 매개변수를 조정합니다.
• 도구 브리지 – Pi 확장 도구를 pi__* 함수로 Cursor에 노출하여 Cursor 측 도구 호출을 가능하게 합니다.
• 빠른/계획 모드 – /cursor-fast 및 /cursor-mode 명령으로 Cursor의 빠른 모드와 계획 모드를 전환합니다.
• 로컬 및 클라우드 런타임 – Cursor 에이전트를 로컬(기본값) 또는 Cursor Cloud에서 실행(/cursor-runtime cloud).
• 청구 가시성 – Cursor 사용 통계(/cursor-usage)를 Pi의 기본 회계와 분리합니다.
• 안전 및 구성 – Pi-Cursor 도구 브리지를 비활성화하고, 로컬 Cursor 설정을 무시하고, HTTP 전송을 제어하는 환경 변수.

시작하기

1. 사전 요구 사항 – Node 24+, Pi 0.87.1+, 및 Cursor SDK API 키(사용자 수준 키, 팀 관리자 키 아님).
2. Pi의 패키지 관리자로 설치:

   pi install npm:pi-cursor-sdk
   pi --model cursor/grok-4.6   # 또는 다른 모델
   

3. Pi 내부에서:
   • /login 실행 → API 키 사용 → Cursor → 키를 붙여넣습니다.
   • /cursor-refresh-models로 모델 카탈로그를 새로 고칩니다.
   • 평소처럼 프롬프트를 입력합니다.

구성 단축키

• 시작 플래그: --cursor-fast, --cursor-no-fast, --cursor-mode plan.
• 환경 변수:
  • PI_CURSOR_FOOTER=0 – 상태 바닥글 숨기기.
  • PI_CURSOR_PI_TOOL_BRIDGE=0 – Pi-Cursor 도구 브리지 끄기.
  • PI_CURSOR_SETTING_SOURCES=none – 로컬 Cursor 구성 파일 무시.

문제 해결 하이라이트

증상	빠른 해결책
모델 목록이 표시되지만 호출 실패	유효한 Cursor SDK 키로 다시 로그인하고 /cursor-refresh-models 실행.
첫 응답이 느림	MCP 서버 설정 확인; "first-cursor-message-is-slow" 문서 참조.
VPN/프록시에서 스트림 끊김	/cursor-http on으로 HTTP 전송 활성화.

문서

• 전체 참조: docs/reference.md
• 개발 노트: docs/development.md
• 유지 관리자를 위한 모델 UX 사양: docs/cursor-model-ux-spec.md
• 변경 로그 및 라이선스가 제공됩니다.

라이선스

• MIT © Mitch Fultz.

---

pi-cursor-sdk는 두 AI 중심 개발자 도구 간의 진정하고 기능적인 브리지로, Pi의 터미널 UI 내에서 Cursor의 LLM과 도구 생태계를 원활하게 사용할 수 있게 합니다.