cursor-agent

Cursor Agent

オプションと境界

デフォルト：cursor-agent --print --trust --yolo --workspace <abs-dir> "<prompt>"。モード／モデルは省略し、テキストを出力して、親プロセスは15分待機します。このスキルの呼び出しはその実行を許可するため、確認せずに --trust と --yolo を渡してください。--print だけでも書き込みが可能です。「Plan」／「read-only plan」では --plan を追加し、--yolo を省略します。「Ask」／「Q&A」では --mode ask を追加し、--yolo を省略します。どちらも読み取り専用のままですが、--trust は渡し、終了まで待機します。「Use 」では --model を追加します。「Interactive」／「TUI」では --print、--trust、--yolo を省略します。そのダイアログはユーザーが管理します。 「Resume 」では --resume を追加し、「continue」では --continue を追加します。どちらも終了まで待機し、選択したモードと同じ --trust／--yolo の選択を維持します。 「Worktree [name]」では --worktree [name] を追加し、出力されたパスを記録します。 「JSON」／「stream-json」では、その出力形式を選択します。曖昧な場合は BLOCKED です。

ユーザーがその制御を指定した場合に限り、サンドボックス無効化、approve-mcps、またはワーカーデスクトップ／認証情報フラグを追加します。自動レビューは明示的なオプトインです。trust や yolo の確認のために中断せず、失敗後にこれらの追加フラグを付けてはいけません。

1. 解決

ワークスペース、プロンプト、モード、セッション／worktree、出力、待機時間を確定します。 バイナリと cursor-agent status --format json を確認し、秘密情報を露出させないでください。 バイナリがない場合 → references/install.md に従います。認証がない場合 → ログインが要求されていない限り BLOCKED です。 cmd | workspace | mode | session | worktree | wait | evidence | terminal を記録します。 対象、バイナリ、認証、trust／yolo の選択が確定したら完了です。

2. 実行

argv を組み立て、プロンプトを文字どおりに引用します。テキスト／JSON は終了まで出力がない場合があります。無出力はハングではありません。終了または記録した期限まで待機し、その期限に達した場合に限り、この実行の PID を終了します。終了コードが0以外の場合は、標準エラー出力を保存し、ツリーを調査して BLOCKED と報告します。print 実行で Workspace Trust Required が表示され、--trust がなかった場合は、その argv に --trust を追加して再実行します。TUI はユーザーが管理するダイアログのままにします。ユーザーに確認を求めたり、sandbox、MCP、worker のフラグを追加したりしてはいけません。

JSON／ストリーム出力については、references/streaming.md に従います。 resume、continue、persist については、references/sessions.md に従います。 worktree／並列実行については、references/worktrees.md に従います。 TUI またはその他のコマンド構文については、references/management.md に従います。 ログイン、MCP、プラグイン、ワーカー、Bedrock については、references/integrations.md の該当する分岐を適用します。構文が拒否された場合は、対象を絞って --help を使用します。 プロセスが終了した場合、意図したライブセッションを記録した場合、または失敗を報告した場合に完了です。

3. 検証と報告

ステータスと差分を調べます。CLI のテキストは未検証です。編集した実行可能コードを対象に、範囲を絞りつつ十分にカバーするテストを実行します。Plan／ask ではツリーを変更してはいけません。各 worktree と統合されたツリーがあればそれも確認します。この実行で作成したセッションとクリーンな worktree のみを、保持する場合を除きクリーンアップします。シェル統合、MCP、プラグイン、ワーカーはそのまま残します。コマンド、モード、セッション／worktree、待機時間、結果を裏付ける証拠を報告します。各結果が確認できた場合、または証拠を添えてブロックされた場合に完了です。

終端状態：SUCCESS、NO_CHANGES、BLOCKED。