メインコンテンツへスキップ

プロンプト設計

最良の結果を得るには、意図をはっきり伝えるのがオススメ。たとえば、エージェントにファイルを一切編集させたくないなら、「do not write any code」というプロンプトを使えばOK。これは、実装に入る前にタスクを計画するときに特に役立つ。 エージェントは現在、ファイル操作・検索・シェルコマンド実行のツールを備えてる。IDE エージェントと同様に、今後さらに多くのツールが追加されていく。

MCP

Agent は拡張機能や統合のために MCP(Model Context Protocol) をサポートしてる。CLI は mcp.json の設定ファイルを自動検出して反映し、IDE で設定したのと同じ MCP サーバーとツールを有効にする。

ルール

CLI エージェントは IDE と同じルールシステムに対応してる。.cursor/rules ディレクトリにルールを作成して、エージェントにコンテキストとガイダンスを与えよう。これらのルールは設定に基づいて自動的に読み込まれて適用されるから、プロジェクトの異なる部分や特定のファイルタイプごとにエージェントの挙動をカスタマイズできる。
CLI は、(存在する場合)プロジェクトルートにある AGENTS.mdCLAUDE.md も読み込み、.cursor/rules とあわせてルールとして適用する。

Agent の使い方

前のメッセージは上矢印(Arrow-Up)で呼び出せて、順番に遡れる。

レビュー

Ctrl+R で変更内容をレビュー。I を押して追加入力を追加。スクロールは Arrow-Up/Arrow-Down、ファイル切り替えは Arrow-Left/Arrow-Right

コンテキストの選択

@ でコンテキストに含めるファイルやフォルダを選択。/compress を実行してコンテキストウィンドウの空きスペースを確保。詳しくは Summarization を参照。

履歴

既存のスレッドから続けるには、--resume [thread id] でこれまでのコンテキストを読み込む。 直近の会話を再開するなら、cursor-agent resume を使う。 これまでの会話の一覧を見たいときは、cursor-agent ls を実行する。

コマンドの承認

ターミナルコマンドを実行する前に、CLI が実行の可否を確認するよ。承認するなら (Y)、拒否するなら (N) を押してね。

非インタラクティブモード

-p または --print を使って Agent を非インタラクティブモードで実行する。レスポンスがコンソールに出力される。 非インタラクティブモードでは、対話なしで Agent を呼び出せる。これにより、スクリプトや CI パイプラインなどに組み込める。 --output-format を併用すると、出力形式を制御できる。たとえば、スクリプトでパースしやすい構造化出力には --output-format json、プレーンテキスト出力には --output-format text を使う。
非インタラクティブモードでは、Cursor はフルの書き込み権限を持つ。
I