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 サーバー）を使用できます。

なぜ重要か

• 2 つの新しい 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 は、2 つの AI に焦点を当てた開発者ツール間の本格的で機能的なブリッジであり、Pi のターミナル UI 内で Cursor の LLM とツールエコシステムをシームレスに使用できます。