Cursor CLI 仕様知識

Cursor IDE および cursor-agent CLI の公式仕様と使用方法のリファレンス。

公式ドキュメント: https://docs.cursor.com/

概要

Cursor は VS Code をベースにした AI 統合コードエディタで、2つの CLI ツールを提供する:

インストール

cursor-agent CLI

curl https://cursor.com/install -fsS | bash

Shell コマンドのパス設定

Cursor エディタ内で:

1. •コマンドパレットを開く（Cmd+Shift+P / Ctrl+Shift+P）
2. •Shell Command: Install 'cursor' command in PATH を実行

参考: https://docs.cursor.com/cli/overview

cursor コマンド（エディタ CLI）

VS Code 互換の CLI オプションを提供。

主要オプション

Git エディタとして設定

git config --global core.editor "cursor --wait"

cursor-agent コマンド（ターミナル AI エージェント）

ターミナルから Cursor AI を直接操作できる CLI。

参考: https://docs.cursor.com/agent/terminal

基本コマンド

利用可能なモデル

-m / --model オプションで指定可能:

例:

cursor-agent -m gpt-5 "タスク説明"
cursor-agent -m sonnet-4 "別のプロンプト"
cursor-agent -m sonnet-4-thinking "複雑な推論タスク"

オプション

インタラクティブモード内コマンド

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 src/main.ts このファイルをリファクタリングして
@Codebase 認証機能はどこに実装されている？
@Web Next.js 15 の新機能を教えて

MCP サーバー連携

Model Context Protocol (MCP) を使用して外部ツールと連携。

参考: https://docs.cursor.com/context/model-context-protocol

設定方法

1. •Cursor Settings > Features > MCP セクション
2. •サーバーを追加
3. •stdio（ローカル）または sse（HTTP/HTTPS）で接続

サポート機能

• •ファイルシステム操作
• •データベースクエリ（Postgres, Supabase など）
• •Google 検索
• •GitHub 連携

CLI コマンド

cursor-agent mcp list                      # 接続済み MCP サーバーとツールを表示
cursor-agent mcp login <identifier>        # MCP サーバーを認証
cursor-agent mcp list-tools <identifier>   # 特定のサーバーが提供するツール一覧表示
cursor-agent mcp disable <identifier>      # MCP サーバーを無効化

スクリプト実行時の MCP 承認

非対話モード（--print）で MCP サーバーを自動的に承認する場合:

cursor-agent --print --approve-mcps "MCP ツールを使用するタスク"

環境変数

cursor-agent が使用する環境変数

使用例

# API キーを環境変数で指定
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 "タスク説明"

設定ファイル

メイン設定ファイルの場所

Cursor 固有の設定例

{
  "cursor.cpp.enabled": true,
  "cursor.chat.model": "claude-3.5-sonnet",
  "cursor.terminal.useAi": true,
  "cursor.composer.enabled": true
}

プロジェクト固有ファイル

.cursor/rules の例

# プロジェクトルール

- TypeScript を使用
- コメントは日本語
- Prettier でフォーマット
- テストは Jest を使用

スラッシュコマンド

定義方法

Markdown ファイルとして .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 との比較

参考リンク

• •公式サイト: https://cursor.com/
• •公式ドキュメント: https://docs.cursor.com/
• •CLI ドキュメント: https://docs.cursor.com/cli/overview
• •エージェント/ターミナル: https://docs.cursor.com/agent/terminal
• •MCP サポート: https://docs.cursor.com/context/model-context-protocol
• •Changelog: https://www.cursor.com/changelog