fitchmultz/pi-cursor-sdk

해결하는 문제

pi-cursor-sdk는 pi 에이전트 런타임 사용자가 Cursor 모델을 사용하면서도 Cursor의 네이티브 SDK 에이전트 루프를 유지할 수 있도록 합니다. 일반적으로 Cursor의 동작을 일반적인 형식으로 변환하는 OpenAI 호환 프록시를 사용할 필요 없이, Cursor의 고유 기능(사고 제어, 세션 동작, 로컬 에이전트 도구 등)을 지원하는 네이티브 통합을 제공합니다.

작동 방식

이 확장은 @cursor/sdk를 pi에 통합합니다. 기본적으로 로컬 기반 런타임을 사용하지만, 명시적으로 Cursor Cloud를 선택할 수 있습니다. 모델 탐지, API 키를 통한 인증, 그리고 pi의 네이티브 제어(예: 사고 수준)를 Cursor SDK 매개변수(예: reasoning 또는 effort)로 매핑합니다. 또한 모델 카탈로그를 캐시하는 시스템을 구현하여 시작 속도를 빠르게 하고, 세션별 SQLite 저장소를 통해 에이전트 재개 및 상태 관리를 처리합니다.

대상 사용자

pi 생태계 내에서 Cursor 모델과 그 에이전트 기능(로컬 SDK 도구 및 MCP 포함)을 직접 일급 접근 권한으로 사용하고자 하는 개발자 및 pi 사용자.

주요 기능

• 네이티브 Cursor 통합: OpenAI 형식의 어댑터가 아닌 Cursor SDK 에이전트 루프를 유지합니다.
• 사고 제어: pi의 사고 수준(medium, xhigh, max)을 Cursor SDK 매개변수로 매핑합니다.
• 유연한 런타임: 기본적으로 로컬 실행을 사용하며, Cursor Cloud 사용을 명시적으로 선택할 수 있습니다.
• 세션 관리: pi 재시작 후 기록된 로컬 SDK 에이전트에 다시 연결할 수 있는 브랜치 범위의 로컬 재개를 지원합니다.
• 빠른 모드: 지속적인 토글(/cursor-fast)과 가상 모델 별칭(예: :fast, :slow)을 제공하여 Cursor의 빠른 매개변수를 지원하는 모델에 대응합니다.
• 모드 전환: CLI 플래그 또는 슬래시 명령어를 통해 agent와 plan 모드 간 전환을 지원합니다.