Cursor と同じランタイム、ハーネス、モデルでエージェントを構築できる Cursor SDK を紹介します。

Cursor のデスクトップアプリ、CLI、ウェブアプリで動作するエージェントを、数行の TypeScript で使えるようになりました。任意の frontier model を使って、手元のマシンでも、専用の VM を使う Cursor のクラウド上でも実行できます。

始めるには、npm install @cursor/sdk を実行し、Cursor SDK プラグイン を使って、Cursor のサポートを受けながら構築を進めてください。

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 は現在、すべてのユーザーがパブリックベータで利用でき、料金は標準のトークンベース従量課金で計算されます。詳しくは、announcement と docs をご覧ください。

このリリースでは、非同期サブエージェントによる新しいマルチタスク機能、改善されたワークツリーの使用体験、そして複数のリポジトリをまたぐ横断的な変更に対応するマルチルートワークスペースを導入しました。

#エージェントウィンドウでマルチタスク

/multitask を使うと、リクエストをキューに追加する代わりに、Cursor が非同期サブエージェントを実行して並列処理します。また、大きなタスクを小さな単位に分割し、複数の非同期サブエージェントが同時に対応できるようにします。

すでにキューにメッセージがある場合も、現在の実行が終わるのを待たずに、それらに対して Cursor にマルチタスクさせることができます。

#エージェントウィンドウのワークツリー

新しくなり、さらに改善されたワークツリーが、エージェントウィンドウで使えるようになりました。

異なるブランチごとに、独立したタスクをバックグラウンドで実行できます。変更をテストする準備ができたら、ワンクリックで任意のブランチをローカルの作業環境に移せます。

#エージェントウィンドウでのマルチルートワークスペース

1 つのエージェントセッションで、複数のフォルダで構成された再利用可能なワークスペースを対象にできるようになりました。

これにより、エージェントがリポジトリ間を移動するたびに対象を切り替えなくても、Cursor でフロントエンド、バックエンド、共有ライブラリにまたがる横断的な変更を行えます。

Cursor は、対話型のキャンバスを作成して応答できるようになりました。

こうしたビジュアル表現には、テーブル、ボックス、図、グラフなどの標準コンポーネントを使って構築されたダッシュボードやカスタムインターフェースに加え、diff や ToDo リストなど、既存の Cursor コンポーネントも含めることができます。

エージェントウィンドウ では、キャンバスはターミナル、ブラウザ、ソース管理と並んでサイドパネルに表示される永続的なアーティファクトです。

Cursor 3.1 のエージェントウィンドウまたはエディターでぜひお試しください。詳しくは 発表記事 をご覧ください。

ターミナルでエージェントとより快適に作業できるよう、Cursor CLI に使い勝手を向上させる改善をリリースしました。

#CLI の Debug Mode

/debug を使うと、再現や理解が難しい厄介なバグの根本原因を突き止めて修正できます。Debug Mode では、Cursor が仮説を立て、ログ文を追加し、ランタイム情報を使って、狙いを定めた修正を行う前に Issue を正確に特定します。

#CLI での /btw サポート

エージェントのメインのタスクを中断させることなく、ちょっとした質問をすばやくできます。/btw を使うと、現在の実行を止めずに、Cursor が行っている変更について確認できます。

#CLI の設定メニュー

/config を開くと、CLI 内の対話型設定パネルが表示され、モデルの選択、既定値、ランタイム設定など、挙動に関する設定を確認したり変更したりできます。

また、/update-cli-config スキルを使って、Cursor に設定変更を適用するよう依頼することもできます。

#CLI のカスタムステータスバー

/statusline を使ってステータスバーをカスタマイズし、現在のモード、ブランチ、環境、アクティブなタスクのヒント、そのほかのセッションメタデータなど、重視するセッションやランタイムのシグナルを表示できます。