Cursor를 구동하는 동일한 런타임, 하네스, 모델로 에이전트를 만들 수 있도록 Cursor SDK를 소개합니다.

Cursor 데스크톱 앱, CLI, 웹 앱에서 실행되는 에이전트를 이제 몇 줄의 TypeScript만으로 사용할 수 있습니다. 로컬 머신에서 실행하거나, 전용 VM이 있는 Cursor 클라우드에서 어떤 프런티어 모델로든 실행할 수 있습니다.

시작하려면 npm install @cursor/sdk를 실행하세요. Cursor의 기본 /sdk 스킬을 사용해 개발을 시작하는 데 도움을 받을 수도 있습니다.

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

몇 가지 샘플 프로젝트를 만들었으며, 공개 repo에서 확인할 수 있습니다. 포크한 뒤 각자의 사용 사례에 맞게 확장해 보세요.

Cursor SDK는 이제 모든 사용자가 공개 베타로 이용할 수 있으며, 표준 토큰 기반 사용량 요금제에 따라 과금됩니다. 자세한 내용은 공지사항과 문서에서 확인하세요.

이번 릴리스에서는 비동기 하위 에이전트를 활용해 여러 작업을 동시에 처리하는 새로운 방식을 도입했으며, 워크트리 사용성을 개선하고 여러 repo에 걸쳐 변경할 수 있도록 멀티 루트 워크스페이스도 추가했습니다.

#Agents Window에서 멀티태스킹하기

/multitask를 사용하면 요청을 대기열에 추가하는 대신 Cursor가 비동기 하위 에이전트를 실행해 병렬로 처리합니다. 또한 더 큰 작업을 더 작은 단위로 나눠 여러 비동기 하위 에이전트가 동시에 처리하게 할 수 있습니다.

이미 대기열에 메시지가 있다면, 현재 실행이 끝날 때까지 기다리는 대신 해당 메시지에 대해 Cursor에 멀티태스킹을 요청할 수도 있습니다.

#Agents Window의 워크트리

Agents Window에 새롭고 개선된 워크트리가 추가되었습니다.

서로 다른 브랜치에서 격리된 작업을 백그라운드에서 실행하세요. 변경 사항을 테스트할 준비가 되면 클릭 한 번으로 원하는 브랜치를 로컬 포그라운드로 가져올 수 있습니다.

#Agents Window의 멀티 루트 워크스페이스

이제 하나의 에이전트 세션에서 여러 폴더로 구성된 재사용 가능한 워크스페이스를 대상으로 사용할 수 있습니다.

덕분에 Cursor는 프런트엔드, 백엔드, 공유 라이브러리 전반에 걸쳐 여러 repo에 걸친 변경을 수행할 수 있으며, repo 사이를 오갈 때마다 에이전트 대상을 다시 지정할 필요가 없습니다.

이제 Cursor는 인터랙티브 캔버스를 만들어 응답할 수 있습니다.

이러한 시각화에는 표, 박스, 다이어그램, 차트 같은 기본 제공 컴포넌트로 만든 대시보드와 맞춤형 인터페이스는 물론, diff와 할 일 목록 같은 기존 Cursor 컴포넌트도 포함될 수 있습니다.

Agents Window에서 캔버스는 터미널, 브라우저, 소스 제어와 함께 사이드 패널에 유지되는 영속적 아티팩트입니다.

Cursor 3.1의 Agents Window 또는 에디터에서 직접 사용해 보세요. 자세한 내용은 공지 글에서 읽어보세요.

터미널에서 에이전트와 작업할 때 더 편리하게 사용할 수 있도록 Cursor CLI에 여러 사용성 개선을 배포했습니다.

#CLI의 Debug Mode

재현하기 어렵거나 이해하기 까다로운 버그의 근본 원인을 찾아 수정하려면 /debug를 사용하세요. Debug Mode에서는 Cursor가 가설을 세우고, 로그 구문을 추가하며, 런타임 정보를 활용해 문제를 정확히 짚어낸 뒤 필요한 부분만 정밀하게 수정합니다.

#CLI에서 /btw 지원

에이전트의 주요 작업 흐름을 방해하지 않고 짧게 곁가지 질문을 할 수 있습니다. /btw를 사용하면 현재 실행을 멈추지 않고도 Cursor가 적용 중인 변경 사항에 대해 설명을 들을 수 있습니다.

#CLI의 설정 메뉴

/config는 CLI 내에서 대화형 설정 패널을 열며, 여기서 모델 선택, 기본값, 런타임 환경설정 등 동작 방식을 확인하고 변경할 수 있습니다.

또한 /update-cli-config 스킬을 사용해 Cursor에 설정 변경을 대신 적용해 달라고 요청할 수도 있습니다.

#CLI의 사용자 지정 상태 표시줄

/statusline을 사용해 상태 표시줄을 사용자 지정하면 현재 모드, 브랜치, 환경, 활성 작업 힌트, 기타 세션 메타데이터를 비롯해 중요하게 확인하고 싶은 세션 및 런타임 신호를 표시할 수 있습니다.