파라미터
Cursor Agent CLI 완전 명령어 레퍼런스
전역 옵션
전역 옵션은 어떤 명령이랑도 같이 쓸 수 있어:| Option | Description |
|---|---|
-v, --version | 버전 번호 출력 |
-a, --api-key <key> | 인증용 API 키 (CURSOR_API_KEY 환경 변수도 사용 가능) |
-p, --print | 응답을 콘솔에 출력(스크립트나 비대화형 사용에 적합). write와 bash를 포함한 모든 도구에 접근 가능 |
--output-format <format> | 출력 형식(--print에서만 동작): text, json, 또는 stream-json (기본값: stream-json) |
-b, --background | 백그라운드 모드로 시작(실행 시 composer 픽커 열기) |
--fullscreen | 전체 화면 모드 켜기 |
--resume [chatId] | 채팅 세션 이어서 진행 |
-m, --model <model> | 사용할 모델 |
-f, --force | 명시적으로 거부하지 않는 한 명령 강제 허용 |
-h, --help | 명령에 대한 도움말 표시 |
명령어
| Command | Description | Usage |
|---|---|---|
login | Cursor에 로그인 | cursor-agent login |
logout | 로그아웃하고 저장된 인증 정보 삭제 | cursor-agent logout |
status | 인증 상태 확인 | cursor-agent status |
mcp | MCP 서버 관리 | cursor-agent mcp |
update|upgrade | Cursor Agent를 최신 버전으로 업데이트 | cursor-agent update 또는 cursor-agent upgrade |
ls | 채팅 세션 목록 보기 | cursor-agent ls |
resume | 가장 최근 채팅 세션 재개 | cursor-agent resume |
help [command] | 명령어 도움말 표시 | cursor-agent help [command] |
명령어를 지정하지 않으면 Cursor Agent는 기본적으로 인터랙티브 채팅 모드로 시작해.
MCP
Cursor Agent에 설정된 MCP 서버를 관리해.| Subcommand | Description | Usage |
|---|---|---|
login <identifier> | .cursor/mcp.json에 설정된 MCP 서버에 인증해 | cursor-agent mcp login <identifier> |
list | 설정된 MCP 서버와 상태를 보여줘 | cursor-agent mcp list |
list-tools <identifier> | 특정 MCP에서 사용 가능한 도구와 각 인자 이름을 보여줘 | cursor-agent mcp list-tools <identifier> |
-h, --help를 지원해.
인수
채팅 모드로 시작할 때 (기본 동작), 초기 프롬프트를 제공할 수 있어: 인수:prompt— 에이전트의 초기 프롬프트
도움말 보기
모든 명령어는 명령어별 도움말을 표시하는 전역-h, --help 옵션을 지원해.