Cursor

Cursor プロバイダーは、Cursor のエージェントを Cursor Agent SDK を通じてリレーのマシンで動かします。OAR は会話ごとに 1 つのワーカープロセスを起動します。エージェントは会話の作業フォルダーで、Cursor アカウントのモデルを使って作業します。Claude と違い、マシン上のサインインは使いません。OAR に Cursor の API キーを渡します。

このページでは Cursor に固有の点を説明します。チャット、キュー、ファイルブラウザーはどのプロバイダーでも同じように動きます。Cursor をほかと比べるにはプロバイダーの概要を参照してください。

必要なもの #

• Cursor の API キー。OAR に一度貼り付けます。有効にするを参照してください。
• インストールするものはありません。Cursor にはマシン上の CLI も Cursor アプリも必要ないので、Cursor サブタブには CLI の行がありません。

各要素の場所：

既定では、状態フォルダーはリレーのデータフォルダーの cursor-agents の下にあります。グローバルインストールでは ~/.oar/data/cursor-agents（Windows では %APPDATA%\oar\data\cursor-agents）、git チェックアウトでは server/data/cursor-agents です。0.9.14 で追加 0.9.14 より前のグローバルインストールでは、状態フォルダーはパッケージのフォルダーの中にあり、更新でそのフォルダーが置き換わるため、会話がエージェントを失うことがありました。フォルダーがまだ残っている会話は、引き続きそれを使います。CURSOR_AGENT_STORE_DIR で場所を移せます。環境変数を参照してください。

有効にする #

Settings → Providers → Cursor（設定 → プロバイダー → Cursor）を開きます。パネルの見出しは Cursor SDK です。

欄の下のステータス行に、現在の状態が表示されます。

保存したときの動作：

• モデルの検出。 Cursor が有効な状態で新しいキーを保存したとき、モデルを変更したとき、または Cursor を再び有効にしたとき、OAR はキーで使えるモデルと、各モデルの推論の選択肢を Cursor に問い合わせます。この問い合わせは 20 秒でタイムアウトします。失敗すると、通知に警告として表示されます（例：Cursor model discovery failed: …）。検出が成功するまで、一覧には既定のモデルだけが入ります。
• キーの変更。 新しいキーを保存すると、検出したモデルが消去され、Cursor が有効なら検出がもう一度実行されます。すでにキーが保存されていた場合、リレーはターンの途中のものも含めてすべての Cursor ワーカーを停止するので、新しいキーはターンの合間に保存してください。ワーカーは次のメッセージで新しいキーを使って再び起動します。
• キーの削除は、Cursor の会話のどれかがメッセージを送ったことがあるか、キューにメッセージがある間は拒否されます：Cannot remove Cursor API key while N active Cursor conversation(s) still exist. Disable Cursor for new conversations instead. そのため、削除によって実行中のターンが影響を受けることはありません。代わりに Cursor をオフにしてください。削除が通ると、まだメッセージを送っていない会話は Copilot に戻ります。Cursor をオフにしただけでは、会話は移りません。

あとは通常どおり会話を始めます。New Chat でプロバイダー Cursor SDK を選びます。会話を始めるを参照してください。

モデルと reasoning effort #

一覧の出どころ。 上に挙げたタイミングで、キーを通じて Cursor 自身から取得します。そのうちどれを入力欄に表示するかは 🤗 Select Models → Cursor SDK（モデルを選択 → Cursor SDK）で選びます。💾 Save enabled models（有効なモデルを保存）で選択を保存し、Refresh（再読み込み）で検出をもう一度実行します。何も選んでいないときは、検出したすべてのモデルが表示されます。Cursor model ID のモデルは常に表示されます。

メッセージごと。 会話では、メッセージごとにモデルと reasoning effort を変えられます。Cursor のモデル ID は Cursor の表記どおりに使います。自分に提供されているモデル（有効にしたもの、Cursor model ID、会話自身のモデル）にない ID は、Cursor model "…" is not available で拒否されます。

reasoning effort。 reasoning effort の選択肢は、モデルが示すとおりにモデルから取得します。OAR が知っているレベルは none、low、medium、high、xhigh、max です。Cursor の extra-high は xhigh として表示されます。OAR が知らないレベルは表示されません。

• none は常に一覧にあります。モデルが推論をオフにできる場合、none は推論をオフにします。できない場合、入力欄ではその項目が default（既定）と表示され、モデルは通常どおりに動きます。
• reasoning effort を示さないモデルには none だけがあり、default と表示されます。
• 思考のスイッチがあるモデルでは、レベルを選ぶと思考がオンになり、none でオフになります。

ほかのモデルのサブエージェント。 Cursor に組み込まれたサブエージェントのメニューでは、少数のモデルしか選べません。そこで OAR は、Select Models で有効にしたモデルごとに 1 つのサブエージェントを宣言します。これでエージェントは、たとえば Grok や GPT のモデルにタスクを任せられます。名前ではドットがダッシュになります（grok-4.5 は grok-4-5）。サブエージェントはそのモデルの既定のバリアントで動き、reasoning effort は指定できません。選択の変更は次のメッセージから有効になります。

Cursor での OAR の機能 #

作業フォルダーの .cursor フォルダーにある Cursor 自身のプロジェクトルール、サブエージェントのファイル、MCP サーバーは読み込まれません。エージェントのツールとサブエージェントは OAR 自身が定義します。

長くアイドルだったエージェント #

30 分使われなかった Cursor のエージェントは閉じられ、次のメッセージで開き直されます。アイドルのまま数時間たつとサインインが古くなるためです。この動作は表に出ません。それでもサインインが古くなっていた場合、OAR はエージェントを作り直してメッセージをもう一度送ります。これを最大 2 回行い、Cursor session re-authenticated; retrying this message on a fresh agent handle. というアクティビティ行を追加します。3 回目に失敗すると、うまくいかないときにあるサインインのメッセージでターンが終わります。

使用状況 #

Cursor のターンでは、返信の下に使用状況の行はありません。📊 Check Usage（使用状況の確認）には Cursor カードがあります。Cursor がオフの間は Cursor is not enabled in provider settings. と表示されます。数値は 2 つの情報源から取得し、カードにはどちらを使ったかが表示されます。

OAR による支出の推定。 OAR は各ターンの後に、エージェントの課金済みの支出を Cursor から読み取り、増えた分を現在の課金サイクルに記録します。各ターンは、それを実行したモデルのプールに振り分けられます。

照合では大文字と小文字を区別せず、ルーターの名前が最初に確認されます。

プランに何が含まれているかを、Cursor は SDK に伝えません。そのため自分で入力します。

メーターは、モデルの生のコストを枠と比べて示します。カードには Cursor が実際に請求した額も表示されます。プランに含まれる利用では、これは 0 のことがよくあります。これらの数値はすべて推定です。Cursor が遅れて報告したコストは、それを確認したターンに記録されます。正確な情報源は Cursor 自身の Spending ダッシュボードで、カードからリンクされています。

ダッシュボードから取得するライブのプランバー。 ダッシュボードのセッショントークンがあると、カードには Cursor のダッシュボードからライブで読み取った Plan usage (total)（プランの使用状況、合計）、Auto + Composer、API のバー、プラン名、プランに含まれる支出とオンデマンドの支出、サイクルの実際の日付が加わります。そのときローカルのプールのメーターは補助的な表示に下がります。このトークンは API キーではなくセッションの Cookie で、API キーではこれらの数値を読み取れません。

OAR は次の順にトークンを探します。

1. 保存したトークン。
2. リレーの環境の CURSOR_SESSION_TOKEN。Cursor アプリのないホスト向けです。
3. リレーのマシンにある Cursor アプリのサインイン。設定なしで、アプリのローカルの状態から読み取ります。

欄の下のステータス行に、使用中の情報源が表示されます。トークンはリレーにとどまり、ブラウザーに送られることはありません。Cursor がトークンを受け付けない場合、カードは推定値に戻り、どの情報源が拒否されたか、またはトークンが見つからなかったことを表示します。

エージェントは、relay_tool の usage アクションで同じ数値を読み取れます。

環境変数 #

リレーを起動する環境で設定します。

API キーはこの方法では設定できません。リレーはパネルのキーをワーカーに渡し、自身の環境にある CURSOR_API_KEY は無視します。

制限 #

上の表にある機能の欠落（軌道修正なし、タスクパネルなし、コンパクト化の設定なし、サブエージェントは 1 階層）のほかに、次の制限があります。

• 質問カードは、エージェントが ask_user を呼び出すかどうかに左右されます。
• 支出と枠は推定です。Cursor から取得するのはダッシュボードのバーだけです。
• Cursor のプランの使用量の上限に達しても、会話は一時停止しません。ターンはほかの失敗したターンと同じように失敗するので、メッセージをもう一度送ります。

うまくいかないとき #