​
전역 옵션

전역 옵션은 어떤 명령과도 함께 쓸 수 있어:
옵션설명
-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명령 도움말 표시

​
명령어

CommandDescriptionUsage
loginCursor에 로그인cursor-agent login
logout로그아웃하고 저장된 인증 정보 삭제cursor-agent logout
status인증 상태 확인cursor-agent status
mcpMCP 서버 관리cursor-agent mcp
update|upgradeCursor 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 서버를 관리해.
SubcommandDescriptionUsage
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>
모든 MCP 명령은 명령별 도움말을 위한 -h, --help를 지원해.

​
Arguments

채팅 모드로 시작할 때(기본 동작) 초기 프롬프트를 제공할 수 있어: Arguments:
  • prompt — 에이전트의 초기 프롬프트

​
도움 받기

모든 명령은 해당 명령에 대한 도움말을 보여주는 전역 -h, --help 옵션을 지원해.