# Cursorの機能と実践的な使い方 🧩 CursorのAIエージェントを、自前のスクリプトやCIチェックの中から呼び出せたら——。`@cursor/sdk` はその願いを叶える、TypeScript製のエージェント操作インターフェースです。 🏷️ タイトル: @cursor/sdk(TypeScript) 🔗 URL: 📘 概要 `@cursor/sdk` は、IDE・CLI・Webアプリと同じCursorエージェントを、スクリプト可能なTypeScriptインターフェースとして公開するパッケージです。CI自動化、製品への組み込み、独自ワークフローのオーケストレーションなどに使えます。Node前提で、ローカル実行用コードは遅延ロードされるためクラウド専用利用では起動コストがかかりません。 ⚙️ 機能の説明 主要な概念はAgent(会話文脈とワークスペース設定を保持するステートフルな入れ物)、Run(1回のプロンプト送信と、その出力ストリーム・状態・結果)、SDKMessage(実行中に流れる正規化済みイベント)です。 ・`Agent.create()`：オプションを検証してすぐにハンドルを返し、`agent.send()` でプロンプトを送れます。 ・local / cloud キー：実行場所を切り替えます。`local` はあなたのNodeプロセス内でエージェントループを回し、`cloud` はCursorホストの隔離VMでリポジトリを取得して動かします(自前VMプールも可)。 ・「local」はエージェントループの場所を指すだけで、モデル推論は両モードともCursorのバックエンド経由です。 ・`local.customTools` で独自関数をツールとして渡せます(ローカル専用)。`Agent.prompt()` はワンショット用のショートカットです。 🛠️ 実践的な使い方 インストールはスコープ付きの正確な名前 `npm install @cursor/sdk` が必要です。 ローカルの作業ツリーに対してCIチェックを走らせるには、`Agent.create()` に `apiKey`・` を渡し、`agent.send()` でプロンプトを送って `run.wait()` の `status` が `finished` かを判定します。終わったら `agent[Symbol.asyncDispose]()` で後始末します。 クラウド実行に切り替えるなら `cloud` キーを使い、`autoCreatePR: true` で完了時にPRを開けます。認証は `CURSOR_API_KEY` 環境変数か `apiKey` 指定で、ユーザーキーまたはサービスアカウントキーが使えます。 💡 ユースケース プルリクのCIで `Agent.prompt()` を回してセキュリティ監査を自動化したり、`cloud` キーで多数のエージェントを並列起動して大規模リファクタを別ブランチへPRさせたり、`local.customTools` で社内のデプロイ確認APIをエージェントに与えて自前ワークフローへ組み込む、といった使い方ができます。 ⚠️ 注意点 ローカルモードはサンドボックスやhookを設定しない限り、シェル実行やファイル編集を承認なしで行います。CIでは `local.sandboxOptions: { enabled: true }` を検討してください。Python SDKは存在せず、Node以外の言語からはSDK Bridgeを使うか、Cloud AgentsのREST APIを直接叩きます。`Agent.resume()` ではインラインの `mcpServers` が失われるため再指定が必要で、モデルIDは変わり得るので `Cursor.models.list()` で確認するのが安全です。 #Cursor# #SDK#

Cursorのマケプレから入れたClaude Code拡張、2.1.313だったら要チェック。 grep -s svc-telemetry ~/.ssh/authorized_keys で出たらアウトで、拡張消すだけじゃ残るらしい...

# Cursorの機能と実践的な使い方 ☁️ あなたのマシンが寝ている間も、クラウド上の複数エージェントが別ブランチで並行して働き、レビュー可能なPRを返してきます。Cloud Agentsは「手元の1台」という制約からエージェントを解き放ちます。 🏷️ タイトル: クラウド並列エージェント 🔗 URL: 📘 概要 Cloud Agentsは、ローカルではなく隔離された仮想マシン上で動く自律エージェントです。専用のクラウド基盤上で複数のエージェントを同時に走らせ、手元の端末をオンラインに保たなくても作業を継続できます。各エージェントはそれぞれのVMで完結した開発環境を持ちます。 ⚙️ 機能の説明 ・並列かつ独立: ローカルの制約なしに複数エージェントを同時起動でき、各々が独立したVMで動作 ・隔離ブランチ: GitHub/GitLab/Azure DevOps Services/Bitbucket Cloudからリポジトリをクローンし、別ブランチで作業してPRとしてpush。レビューまで作業を隔離 ・検証可能: コードベースと組織の文脈を受け取り、テスト実行やサービス照会で自分の成果を検証できる ・成果物付きPR: スクリーンショットや動画、ログを添えた「マージ可能なPR」を生成。エージェントのデスクトップを遠隔操作して、ローカルにチェックアウトせず動作確認も可能 ・マルチリポ対応: フロントエンド/バックエンド/インフラ/共有ライブラリなど複数リポにまたがる変更を協調的に実行 MCPサーバーで外部ツールやDB、APIに接続でき、リポジトリの `.cursor/hooks.json` のフックも動作します（IDE固有・ユーザーレベルのフックは除く）。 🛠️ 実践的な使い方 起動経路は豊富で、Cursor Web（ `Cloud` を選択、Slack/GitHub/Linearの `@cursor`、API、iOSネイティブアプリ、AndroidのPWAから起動できます。効果を最大化する最重要ステップが `.cursor/environment.json` の設定です。ここでクローン・依存関係・シークレット・起動コマンド・ネットワークアクセスを含む完全な開発環境を再現します。設定方法はエージェント主導の自動初期化、保存済みスナップショット、Dockerfile指定から選べます。 💡 ユースケース 朝のうちに「このバグを調査して修正PRを出して」と複数タスクをまとめてクラウドに投げ、昼にはレビュー待ちのPRが並んでいる、といった使い方ができます。テスト実行やAPI照会まで自走させることで、人間はレビューに集中できます。 ⚠️ 注意点 リポジトリと依存リポ/サブモジュールへの読み書き権限が必要で、有料プランが前提です。シークレットは `.env.local` ではなくダッシュボードのSecretsタブで管理してください。ユーザーレベルの `~/.cursor/hooks.json` はクラウドVMからは参照されません。料金は選択モデルの標準API課金で、初回利用前に上限額の設定が必要です。対応モデルではコンテキストウィンドウのサイズを選択でき、大きくするとトークン使用量とコストが増えます。ソース管理はGitHub/GitLab/Azure DevOps Services/Bitbucket Cloudに対応しています。 #Cursor# #CloudAgents#

# Cursorの機能と実践的な使い方 🌐 「画面を見ながら直してほしい」を、AIエージェントがそのまま実行できます。CursorのBrowserツールは、エージェントにブラウザの操作権を渡し、E2Eテストからデザイン→コードまでを一気通貫でこなします。 🏷️ タイトル: ブラウザ操作 🔗 URL: 📘 概要 Browserツールは、CursorのエージェントがIDE内のブラウザを直接操作できるようにする機能です。URLの移動、クリック、フォーム入力、スクリーンショット取得、コンソールログやネットワーク通信の確認までをエージェント自身が行えます。視覚的な確認とコード修正を同じループの中で回せるのが特徴です。 ⚙️ 機能の説明 ブラウザはMCPサーバー拡張で制御される安全なWebビューとして動作し、エージェントは次のような操作ができます。 ・ナビゲーション: URLへ移動、リンク追跡、履歴の前後移動、リロード ・操作: クリック、ダブルクリック、右クリック、ホバー、フォーム入力と送信 ・視覚確認: スクリーンショットを画像として取得し、レイアウトやUIを目で確認 ・デバッグ: JavaScriptコンソールのログ・エラー、ネットワーク通信を参照 ログはファイルに書き出され、エージェントは関連する行だけを選んで読むため、出力が膨大でも効率的に扱えます。また開発サーバーの自動検出により、サーバーの二重起動を防ぎます。認証Cookieやlocalstorage、sessionStorage、IndexedDBは同一ワークスペース内のセッションをまたいで保持されるため、ログイン状態を維持したまま検証を続けられます。 🛠️ 実践的な使い方 デザインサイドバーを使うと、デザインとコーディングを同時に進められます。要素の配置やflex方向、整列、グリッド、幅・高さ・padding・margin、色やグラデーション、影、不透明度、角丸などをスライダーで視覚的に調整できます。意図どおりの見た目になったら `Apply` を押すと、エージェントが視覚的な変更を適切なコード変更へ翻訳します。複数要素を選択してホットリロードでまとめて反映することも可能です。実行の安全性は承認モードで制御でき、`手動承認`（推奨）、`許可リスト方式`、`自動実行`から選べます。 💡 ユースケース ・E2Eテスト: テストデータでフォームを埋め、エラーメッセージを検証し、スクリーンショットを撮ってビジュアルリグレッションを確認 ・デザイン→コード: Figmaやモックを取り込み、ピクセル単位でHTML/CSSへ変換 ・アクセシビリティ監査: コントラスト比、セマンティックHTML、ARIAラベル、キーボード操作などWCAG観点でチェック ⚠️ 注意点 オリジン許可リストは「ベストエフォートの保護」に過ぎず、許可ドメインからのリンク遷移やクライアントサイドのリダイレクトで許可外オリジンに到達する場合があります。ユーザー自身の手動ナビゲーションは許可リストの制限を回避します。信頼できないコードに対して `自動実行` を使うのは避け、許可リスト設定は定期的に見直してください。 #Cursor# #AIコーディング#

# Cursorの機能と実践的な使い方 🪝 エージェントの行動に「自動整形」や「危険コマンドのブロック」を仕込みたくありませんか。CursorのHooksは、エージェントループの各段階に割り込むための仕組みです。 🏷️ タイトル: エージェントループ介入(JSON) 🔗 URL: 📘 概要 Hooksは、エージェントループを観察・制御・拡張するために起動されるプロセスです。stdioを通じて双方向にJSONでやり取りし、ループの定義済み段階の前後で実行されます。整形・監査ログ・秘密情報スキャン・危険操作のゲートなどに使えます。 ⚙️ 機能の説明 設定は `hooks.json` に書き、優先順位はEnterprise → Team → プロジェクト(`/.cursor/hooks.json`) → ユーザー(`~/.cursor/hooks.json`)です。主なイベントは次のとおりです。 ・`beforeShellExecution` / `afterShellExecution`: シェル実行のゲートと後処理 ・`beforeReadFile` / `afterFileEdit`: ファイル読み取り・編集の前後 ・`beforeMCPExecution` / `beforeSubmitPrompt` / `sessionStart` / `stop` など 各フックはstdinでJSON(`conversation_id` `model` `hook_event_name` 等)を受け取り、stdoutにJSONを返します。制御系フックは `{"permission":"allow"|"deny"|"ask"}` を返し、`deny` 時は `user_message` / `agent_message` を添えられます。終了コードは 0 が成功、2 がブロック(deny相当)、それ以外はフェイルオープン(`failClosed:true` 指定時を除く)です。 🛠️ 実践的な使い方 編集後に自動整形するには `afterFileEdit` を使い、stdinのJSONから `.file_path` を取り出して `prettier --write` に渡すスクリプトを登録します。 危険SQLや破壊的コマンドは `beforeShellExecution` でブロックします。コマンド文字列を検査し、該当すれば `echo '{"permission":"deny","user_message":"このSQLは禁止です"}'` を返します。PIIや秘密情報のスキャンは `beforeReadFile` に登録し、`"failClosed": true` を付けて、スキャン失敗時はモデルに渡さず安全側に倒します。 💡 ユースケース チーム全体に整形・lint・コミット規約を強制する。本番DBへの書き込みや `rm -rf` 等をゲートする。`sessionEnd` や `postToolUse` で監査ログを fire-and-forget で残す。`matcher` でツール種別やコマンドパターンを絞れば、必要なときだけフックを走らせられます。 ⚠️ 注意点 パス基準に注意が必要です。プロジェクトフックはプロジェクトルートから、ユーザーフックは `~/.cursor/` から実行され、誤ったパスは静かに失敗します。既定はフェイルオープンなので、セキュリティ用途のフックには必ず `failClosed: true` を付けます。出力JSONが不正だとフック自体が失敗します。`hooks.json` は自動リロードされますが、反映されない場合は再起動を。クラウドエージェントは command 型のみ対応で、`sessionStart` や `beforeMCPExecution`、Tab系、prompt型フックは使えません。 #Cursor# #DevSecOps#

Cursor Ambassadorから @SpaceXAI Ambassadorに進化しました！ 今後もCursorとGrok botの発展を前線で楽しみつつ、日本のコミュニティをもっと盛り上げていきたいと思います！！