Gemini CLI Commands

Gemini CLI에서는 세션 관리, 인터페이스 사용자 정의, 동작 제어를 위한 여러 내장 명령어를 지원함. 이 명령어들은 슬래시(/), 골뱅이(@), 또는 느낌표(!)로 시작함.

/bug: 버그 리포트 제출

Gemini CLI 사용 중 발견한 문제에 대해 이슈를 제출함. 기본적으로 Gemini CLI의 GitHub 저장소에 이슈가 등록되며, /bug 뒤에 입력하는 내용이 이슈의 제목이 됨.

.gemini/settings.json 파일의 bugCommand 설정을 통해 기본 동작 변경 가능.

/chat: 대화 기록 관리

대화 기록을 저장하고 불러와서, 대화의 분기를 만들거나 이전 대화 상태를 이어갈 수 있음.

• /chat save <태그>: 현재 대화 내용을 특정 <태그>로 저장함.
• /chat resume <태그>: 저장했던 <태그>의 대화 내용을 불러옴.
• /chat list: 저장된 모든 태그 목록을 보여줌.

# 현재 대화 내용을 'my-topic'이라는 이름으로 저장
/chat save my-topic
 
# 'my-topic' 대화 내용 불러오기
/chat resume my-topic

스냅샷 기능이랑은 다른 개념임. 이건 대화 내용을 저장해두는 거임.

/clear: 화면 정리

터미널 화면에 보이는 모든 내용을 지워줌. Ctrl+L 단축키로도 실행 가능.

/compress: 대화 내용 요약

지금까지의 전체 대화 내용을 하나의 요약본으로 압축하여 대체함. 이후 작업에서 토큰 사용량을 절약하면서 이전 맥락을 유지하고 싶을 때 유용함.

/editor: 편집기 선택

지원되는 편집기 목록을 열어 선택할 수 있게 해줌.

/help: 도움말 표시

Gemini CLI에서 사용 가능한 명령어와 그 사용법에 대한 도움말을 표시함.

/mcp: MCP 서버 및 도구 목록 표시

연결 설정된 MCP 서버의 목록, 연결 상태, 서버 정보, 사용 가능한 도구들을 보여줌.

• /mcp desc: 서버와 도구에 대한 상세 설명을 함께 표시함.
• /mcp nodesc: 도구 이름만 간략하게 표시함.
• /mcp schema: 도구의 설정 매개변수에 대한 전체 JSON 스키마를 보여줌.
• Ctrl+T: 도구 설명 표시/숨기기 토글 단축키.

/memory: 메모리 관리

GEMINI.md 파일로부터 로드된 작업 지시사항를 관리함.

• /memory add <기억할 내용>: 입력한 텍스트를 AI의 메모리에 추가함.
• /memory show: 현재 로드된 전체 메모리의 내용을 표시함.
• /memory refresh: 모든 GEMINI.md 파일로부터 메모리를 다시 불러와 업데이트함.

/restore: 작업 실행 이전 상태로 복원

도구가 파일을 수정한 경우, 실행 직전 상태로 프로젝트 파일을 복원함. 파일 편집 작업을 취소하고 싶을 때 유용함. tool_call_id 없이 실행하면 복원 가능한 체크포인트 목록을 보여줌.

스냅샷 옵션을 사용하거나 설정에서 활성화한 경우에만 사용 가능.

/restore [tool_call_id]

/stats: 세션 통계 표시

현재 세션의 토큰 사용량, 캐시된 토큰 절약량, 세션 지속 시간 등 상세한 통계를 표시함.

/theme: 테마 변경

Gemini CLI의 시각적 테마를 변경할 수 있는 대화상자를 염.

/auth: 인증 방식 변경

인증 방식을 변경할 수 있는 대화상자를 염.

/about: 버전 정보 표시

버전 정보를 보여줌. 버그 리포트 시 이 정보를 함께 공유하면 문제 해결에 도움이 됨.

/tools: 사용 가능한 도구 목록 표시

현재 Gemini CLI 내에서 사용 가능한 도구 목록을 보여줌.

• /tools desc: 각 도구의 상세 설명을 함께 표시함.
• /tools nodesc: 도구 이름만 간략하게 표시함.

/privacy: 개인정보 처리방침 표시

개인정보 처리방침을 표시하고, 서비스 개선을 위한 데이터 수집 동의 여부를 사용자가 선택할 수 있게 함.

/quit (또는 /exit): 종료

Gemini CLI를 종료함.

@<파일/디렉토리 경로>: 파일/디렉토리 내용을 프롬프트에 포함

지정한 파일이나 디렉토리의 내용을 현재 프롬프트에 주입함. 특정 코드나 텍스트에 대해 질문할 때 유용함.

# 파일 내용에 대해 질문하기
@src/main.js 이 코드의 기능을 설명해줘.
 
# 디렉토리 내 코드 요약하기
@src/components/ 이 디렉토리의 역할이 뭐야?

• 기본적으로 .gitignore에 명시된 파일들(예: node_modules/, .git/)은 제외됨.
• 경로에 공백이 있는 경우 백슬래시(\)로 이스케이프 처리해야 함 (예: @My\ Documents/file.txt).

!<셸 명령어>: 셸 명령어 실행 및 셸 모드 전환

! 접두사를 사용하여 Gemini CLI 내에서 직접 시스템의 셸 명령어를 실행할 수 있음.

• !<명령어>: 해당 명령어를 즉시 실행하고 결과를 터미널에 표시함.
• !: 단독으로 입력 시, 입력을 셸 명령으로 직접 처리하는 ‘셸 모드’로 전환하거나 원래 모드로 복귀함.

해당 셸 모드에서 실행하는 명령어는 터미널에서 직접 실행하는 것과 동일한 권한을 가지므로 주의가 필요함.

# 현재 디렉토리 파일 목록 보기
!ls -l
 
# git 상태 확인
!git status

---

위 내용은 아래 글을 기반으로 정리한 내용임.

• https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/commands.md