| name | cursor-cli-knowledge |
| description | Use when user asks about Cursor, cursor command, cursor-agent, terminal agent, @ symbols, model selection, MCP servers, Composer, or Cursor settings. Also use when user says Cursor について, cursor の使い方, cursor-agent, ターミナルエージェント. Cursor IDE および cursor-agent CLI の仕様と使い方に関する知識を提供し、エディタ CLI、ターミナルエージェント、モデル選択、@ シンボル、MCP サーバー連携、Composer、設定方法について回答する。 |
| context | fork |
Cursor CLI 仕様知識
Cursor IDE および cursor-agent CLI の公式仕様と使用方法のリファレンス。
公式ドキュメント: https://docs.cursor.com/
概要
Cursor は VS Code をベースにした AI 統合コードエディタで、2つの CLI ツールを提供する:
| CLI | 説明 |
|---|
cursor | VS Code 互換のエディタ CLI。ファイルを開く、diff 表示、拡張機能管理など |
cursor-agent | ターミナルから AI エージェントを直接操作する CLI |
インストール
cursor-agent CLI
curl https://cursor.com/install -fsS | bash
Shell コマンドのパス設定
Cursor エディタ内で:
- コマンドパレットを開く（
Cmd+Shift+P / Ctrl+Shift+P）
Shell Command: Install 'cursor' command in PATH を実行
参考: https://docs.cursor.com/cli/overview
cursor コマンド（エディタ CLI）
VS Code 互換の CLI オプションを提供。
主要オプション
| オプション | 説明 | 例 |
|---|
cursor . | 現在のディレクトリを開く | |
cursor <path> | ファイル/ディレクトリを開く | cursor src/main.ts |
-n, --new-window | 新しいウィンドウで開く | cursor -n project/ |
-r, --reuse-window | 最後のウィンドウで開く | cursor -r file.ts |
-d <file1> <file2> | 2ファイルの差分を表示 | cursor -d old.ts new.ts |
-g <file>:<line> | 指定行でファイルを開く | cursor -g src/main.ts:42 |
-w, --wait | ウィンドウが閉じるまで待機 | |
--install-extension <id> | 拡張機能をインストール | |
--list-extensions | 拡張機能一覧を表示 | |
Git エディタとして設定
git config --global core.editor "cursor --wait"
cursor-agent コマンド（ターミナル AI エージェント）
ターミナルから Cursor AI を直接操作できる CLI。
参考: https://docs.cursor.com/agent/terminal
基本コマンド
| コマンド | 説明 |
|---|
cursor-agent | 対話型セッションを開始 |
cursor-agent "プロンプト" | 非対話モードでタスク実行 |
cursor-agent login | 認証 |
cursor-agent logout | ログアウト |
cursor-agent status | 認証状態を確認 |
cursor-agent update | CLI を更新 |
cursor-agent ls | セッション一覧を表示 |
cursor-agent resume [chatId] | セッションを再開 |
cursor-agent mcp list | MCP サーバーとツールを確認 |
cursor-agent create-chat | 新規チャットを作成（ID を返す） |
cursor-agent install-shell-integration | ~/.zshrc にシェル統合をインストール |
cursor-agent uninstall-shell-integration | シェル統合を削除 |
cursor-agent agent [prompt...] | エージェントモードを開始 |
利用可能なモデル
-m / --model オプションで指定可能:
| モデル | 説明 |
|---|
gpt-5 | OpenAI GPT-5 |
sonnet-4 | Claude Sonnet 4 |
sonnet-4-thinking | Claude Sonnet 4 with Extended Thinking |
例:
cursor-agent -m gpt-5 "タスク説明"
cursor-agent -m sonnet-4 "別のプロンプト"
cursor-agent -m sonnet-4-thinking "複雑な推論タスク"
オプション
| オプション | 説明 |
|---|
-p, --print | 応答を標準出力に表示（スクリプト用） |
-m, --model <model> | AI モデルを指定（gpt-5, sonnet-4, sonnet-4-thinking） |
-f, --force | 確認なしでコマンド実行 |
--output-format <format> | 出力形式: text, json, stream-json |
-a, --api-key <key> | API キーを直接指定 |
-H, --header <header> | カスタムヘッダーを追加（複数回使用可） |
--stream-partial-output | 部分出力をストリーミング |
-c, --cloud | クラウドモード（Composer picker 起動） |
--sandbox <mode> | サンドボックスモード: enabled, disabled |
--approve-mcps | MCP サーバーを自動承認（--print モード用） |
--browser | ブラウザ自動化サポートを有効化 |
--workspace <path> | ワークスペースディレクトリを指定 |
インタラクティブモード内コマンド
| コマンド | 説明 |
|---|
@ | ファイル/フォルダをコンテキストに追加 |
/model | 使用モデルを変更 |
/auto run | コマンド自動実行モードの切替 |
/new chat | 新規チャットを開始 |
AI 機能
Cursor Composer
マルチファイル編集機能。複数ファイルにまたがる変更を一度に生成・適用できる。
- マルチファイル編集: 複数ファイルの同時変更
- 自律的ファイル操作: ファイルの作成/削除/移動
- チェックポイント: 変更適用前の確認と復元
Inline Edit（Ctrl+K / Cmd+K）
選択したコード範囲に対して AI に直接変更を指示。
- コード選択後に
Ctrl+K（Windows/Linux）または Cmd+K（macOS）
- 自然言語で変更内容を指示
- インラインで差分をプレビュー
エージェントモード
複雑なタスクを自律的に実行するモード。
- ファイルの読み書き
- コマンドの実行
.cursor/rules に従った動作
ターミナル AI 支援
- 自然言語からコマンドを提案
@ シンボルでファイル/コードをコンテキストに追加
@ シンボル（コンテキスト指定）
AI に追加のコンテキストを提供するためのシンボル。
参考: https://docs.cursor.com/context
| シンボル | 説明 |
|---|
@Files | 特定のファイルをコンテキストに含める |
@Folders | フォルダ全体の情報を参照 |
@Code / @Symbols | 関数、クラス、変数などのシンボルを参照 |
@Docs | サードパーティライブラリのドキュメントを参照 |
@Web | ウェブ検索を実行 |
@Codebase | プロジェクト全体のコードベースをスキャン |
@Git | コミット履歴や現在の差分を参照 |
使用例
@Files src/main.ts このファイルをリファクタリングして
@Codebase 認証機能はどこに実装されている？
@Web Next.js 15 の新機能を教えて
MCP サーバー連携
Model Context Protocol (MCP) を使用して外部ツールと連携。
参考: https://docs.cursor.com/context/model-context-protocol
設定方法
Cursor Settings > Features > MCP セクション- サーバーを追加
stdio（ローカル）または sse（HTTP/HTTPS）で接続
サポート機能
- ファイルシステム操作
- データベースクエリ（Postgres, Supabase など）
- Google 検索
- GitHub 連携
CLI コマンド
cursor-agent mcp list
cursor-agent mcp login <identifier>
cursor-agent mcp list-tools <identifier>
cursor-agent mcp disable <identifier>
スクリプト実行時の MCP 承認
非対話モード（--print）で MCP サーバーを自動的に承認する場合:
cursor-agent --print --approve-mcps "MCP ツールを使用するタスク"
環境変数
cursor-agent が使用する環境変数
| 環境変数 | 説明 | 例 |
|---|
CURSOR_API_KEY | Cursor API キーを指定（--api-key オプションの代わりに使用） | export CURSOR_API_KEY=your-key |
NO_OPEN_BROWSER | 値が true または 1 の場合、ブラウザの自動起動を無効化 | export NO_OPEN_BROWSER=1 |
使用例
export CURSOR_API_KEY=sk-xxxxx
cursor-agent "タスク実行"
export NO_OPEN_BROWSER=1
cursor-agent
export CURSOR_API_KEY=sk-xxxxx
export NO_OPEN_BROWSER=1
cursor-agent -m gpt-5 "タスク説明"
設定ファイル
メイン設定ファイルの場所
| OS | パス |
|---|
| macOS | ~/.config/cursor/ |
| Linux | ~/.config/cursor/ |
| Windows | %APPDATA%\Cursor\ |
| ワークスペース | .vscode/settings.json |
Cursor 固有の設定例
{
"cursor.cpp.enabled": true,
"cursor.chat.model": "claude-3.5-sonnet",
"cursor.terminal.useAi": true,
"cursor.composer.enabled": true
}
プロジェクト固有ファイル
| ファイル/ディレクトリ | 説明 |
|---|
.cursor/rules | AI エージェントへのカスタムルール |
.cursor/hooks.json | イベントフック定義 |
.cursor/commands/ | カスタムスラッシュコマンド |
cli-config.json | CLI ツールの動作設定 |
.cursor/rules の例
# プロジェクトルール
- TypeScript を使用
- コメントは日本語
- Prettier でフォーマット
- テストは Jest を使用
スラッシュコマンド
定義方法
Markdown ファイルとして .cursor/commands/ に保存。
保存場所
| 場所 | スコープ |
|---|
.cursor/commands/ | プロジェクト単位 |
~/.cursor/commands/ | グローバル |
例
.cursor/commands/test.md:
選択したコードのユニットテストを生成してください。
Jest を使用し、エッジケースも含めてください。
使用: /test でコマンドを実行
よくある質問
Q: cursor-agent が見つからない
A: インストールスクリプトを実行:
curl https://cursor.com/install -fsS | bash
その後、シェルを再起動するか source ~/.bashrc を実行。
Q: cursor コマンドが PATH にない
A: Cursor エディタで Shell Command: Install 'cursor' command in PATH を実行。
Q: MCP サーバーが接続できない
A: cursor-agent mcp list で接続状態を確認。設定が正しいか確認し、サーバーが起動しているかチェック。
Q: @ シンボルが機能しない
A: ファイルパスが正しいか確認。@Files の後にスペースを入れてからファイル名を入力。
Q: エージェントモードで実行したコマンドを確認したい
A: cursor-agent ls でセッション一覧を表示し、cursor-agent resume [chatId] で履歴を確認。
Q: cursor-agent で使用できるモデルは？
A: cursor-agent -m <model> で指定。利用可能なモデルは Cursor アカウントのプランによる。
Claude Code との比較
| 機能 | Cursor | Claude Code |
|---|
| スラッシュコマンド | .cursor/commands/ | .claude/commands/ |
| ルール/設定 | .cursor/rules | CLAUDE.md |
| MCP サポート | あり | あり |
| ターミナル CLI | cursor-agent | claude |
| コンテキスト指定 | @ シンボル | @ シンボル |
| フック | .cursor/hooks.json | .claude/settings.json |
参考リンク
