Gemini-cli: slash command

Gemini CLI의 slash command 소개

Gemini CLI에서 /memory, /stats, /tools, /settings처럼 /로 시작하는 입력을 slash command 라고 지칭함.

• 이는 built-in command 로 분류,
• 이는 일반 prompt 가 아니라 CLI 자체를 제어하는 meta-level control 임.

다음과 같이 prompt 와 차이가 있음:

• prompt는 모델에게 일을 시키는 문장이고,
• slash command는 Gemini CLI라는 도구 자체를 조작하는 command임.

즉, 작업 내용을 지시할 때는 prompt를 쓰고, 작업 환경을 설정 및 관리할 때는 slash command를 쓴다고 생각하면 됨.

built-in command 는
session 관리,
interface customization,
behavior control
을 위해 제공됨.

---

왜 필요한가

Gemini CLI는 다음의 요소를 함께 관리하고 있는 agent형 CLI임:

• session history
• memory
• tools
• MCP server
• skills
• settings

그래서 자연어로 구성된 prompt 만으로 모든 상태를 정확히 다루기보다는, 정해진 command로 직접 제어하는 방식이 필요함.

 

사용예:

• 현재 memory 에 어떤 내용이 있는지를 확인: /memory show
• 이전 작업을 다시 이어가고 싶은 경우: /resume
• 현재 CLI 버전을 확인: /about

---

가장 먼저 익힐 command

처음부터 모든 command를 외울 필요는 없으며, 다음의 slash command만 간단히 사용해보면 된다:

/help

• 사용 가능한 command를 확인할 때 쓰는 기본 entry point임.

---

/about

• 현재 설치된 Gemini CLI 버전을 확인할 때 유용함.

문서와 기능이 안 맞는 것 같을 때는 버전부터 확인할 것

---

/stats

• 현재 session 통계를 보는 command임.
• session, model, tools 같은 subcommand 가 있음,
• 로그인한 아이디, session duration, token count, quota, tool 사용 현황 등을 볼 수 있음.

---

/memory

"지금 무엇을 기억하고 있는가"를 확인하는 command.

• 현재 instruction context를 관리하는 command 임.
• Gemini CLI는 GEMINI.md 계층을 memory source로 사용
• /memory show
  • 현재 모델에 실제로 주입된 내용을 볼 수 있음,
• /memory refresh
  • 또는 관련 subcommand로 다시 불러올 수 있음.

---

/resume

• 이전 session을 다시 이어갈 때 쓰는 command.
• session management 용으로 past session을 browse하고 이어서 작업할 수 있게 해 줌.
• 긴 작업을 여러 날에 걸쳐 이어갈 때 특히 중요함.
• conversation 만을 복원하며, cross session으로 동작가능함.

/rewind, /restore 도 session을 관리하는 다른 slash command임. 다음 url을 살펴볼 것.

2026.03.26 - [개발환경] - Gemini-cli: session 저장 및 되돌리기

Gemini-cli: session 저장 및 되돌리기

 

 

---

/settings

• 설정 화면을 여는 command.
• 설정은 settings.json으로도 관리할 수 있으나
• /settings를 통해 UI에서 직접 조정할 수도 있음.

예를 들어 approval mode, Vim mode, experimental option 같은 설정을 바꿀 때 자주 쓰게 됨.

---

/tools

• 현재 사용 가능한 tool과 상태를 확인할 때 쓰는 command
• tool은 Gemini CLI가 직접 호출해서 실제 작업을 수행하는 실행 기능임.
• 예를 들어 file을 읽거나, shell command를 실행하거나, web fetch를 하거나, MCP server를 통해 외부 기능을 부르는 것이 tool임.

2026.03.14 - [utils] - Gemini-CLI: Custom Tool

Gemini-CLI: Custom Tool

---

/skills

• skill 목록과 상태를 관리할 때 쓰는 command .
  • /skills list
  • /skills reload
  • /skills enable
  • /skills disable

skill은 앞서 다룬 tool들을 묶어서 특정 작업에 맞는 전문 지식, 절차, 자료를 제공하는 패키지임.

• 사실 skill은 SKILL.md를 루트에 둔 self-contained directory 로서
• 직접 file을 지우거나 API를 호출하는 실행기(=tool)라기보다,
• "이 작업을 어떤 순서와 기준으로 처리할지"를 Gemini에게 알려 주는 작업 가이드 패키지에 가까움.

2026.03.16 - [개발환경] - Gemini CLI: Extension, Skill, MCP, Tool (정리)

Gemini CLI: Extension, Skill, MCP, Tool (정리)

---

slash command는 interactive command의 한 종류임

interactive command 는 다음의 세종류의 prefix를 가짐:

• / : CLI control command
• @ : file이나 directory를 prompt에 포함시키는 용도
• ! : shell passthrough command

다음의 예가 이들의 차이점을 보여줌:

/memory show
@src
!pwd

• 첫 번째는 CLI 상태를 확인하는 slash command
• 두 번째는 file context를 prompt에 포함시키는 at command
• 세 번째는 실제 shell command를 실행하는 passthrough command임.

slash command는 채팅처럼 문장을 길게 쓸 필요가 없고,

정해진 command 이름을 그대로 치면 되고

일부 명령어들은 다음과 같이 subcommand를 지원함:

/memory show
/memory refresh
/stats session # 모델별 token을 얼마나 소모했는지 등을 표시
/stats tools   # 어느 tool이 얼마나 호출되었는지 등
/skills list
/skills reload

---

Simple Tutorial

1. 도움말과 버전 확인

/help
/about

• /help로 현재 CLI에서 사용할 수 있는 command를 보여줌.
• /about으로 현재 버전을 확인 가능.

---

2. 현재 memory 확인

/memory show

• Gemini CLI가 왜 특정 규칙을 따르는지, 왜 어떤 instruction을 기억하는지 등을 확인 가능.
• GEMINI.md를 수정한 뒤 해당 context의 반영 여부를 확인할 때도 유용함.

GEMINI.md를 수정 후 다시 읽게 만들고 싶다면 다음처럼 사용함.

/memory refresh

 

다음의 명령으로 context에 특정 룰을 추가할 수도 있음

memory add

 

즉, /memory 계열은

• memory source와
• 현재 context를 관리하는데 사용됨.

 

 

참고로, 대화가 길어져서 context가 한도에 도돌하게 되는 경우, /compress 명령을 통해 현 context를 요약 압축할 수도 있음.

---

3. 현재 session 사용량 확인

/stats session
/stats tools

• /stats는 전체적인 통계량을 보여줌.
• session이나 tools 같은 subcommand 를 붙여서 사용됨.

long session에서 token usage나 tool call 현황을 확인할 때 유용함.

---

4. 설정 바꾸기

/settings

• 이 command를 입력하면 settings UI를 열 수 있음.
• 예를 들어 Plan Mode 기본값이나 experimental 기능을 켜는 작업은 /settings에서 바로 처리 가능.

---

5. 예전 작업 다시 이어가기

/resume

• Gemini CLI를 닫았다가 다시 켰을 때, 이전 대화를 이어서 진행하고 싶은 경우 이용.
• session management tutorial도 resume, browse, rewind를 주요 workflow로 설명함.

https://geminicli.com/docs/cli/tutorials/session-management/

Manage sessions and history

---

6. skill 상태 보기

/skills list
/skills reload

• skill을 쓰는 경우에는 이 두 command가 기본임.
• 현재 발견된 skill을 보고 싶으면 list,
• 새로 link하거나 수정한 뒤 다시 읽고 싶으면 reload를 쓰면 됨.

---

custom slash command도 존재함

custom slash command 추가도 가능함.

• 자주 쓰는 prompt를 command처럼 저장하고 재사용할 수 있음.
• .gemini/commands/ 나 user-level command directory의 .toml 파일을 통해 custom command를 관리 가능.
  /commands reload로 이를 적용 가능.

2026.03.26 - [개발환경] - Gemini-cli: Custom Slash Command 만들기

Gemini-cli: Custom Slash Command 만들기

 

slash command는 단순히 원래 내장된 기능만 뜻하는 것이 아니라,
나중에는 사용자가 자기 workflow에 맞게 확장할 수도 있는 구조임.

 

다만 초보자 단계에서는 built-in command부터 익히는 것이 먼저임.

---

정리

• slash command는 Gemini CLI에서 /로 시작하는 관리용 command임.
• 일반 prompt처럼 모델에게 작업을 설명하는 문장이 아니라, memory, stats, session, settings, tools, skills 같은 CLI 내부 상태를 직접 다루는 interface임.

---

같이 보면 좋은 자료들

2026.03.16 - [개발환경] - Gemini CLI: Extension, Skill, MCP, Tool (정리)

Gemini CLI: Extension, Skill, MCP, Tool (정리)

2026.03.14 - [utils] - Gemini-CLI: Custom Tool

Gemini-CLI: Custom Tool

2025.12.26 - [CE] - Gemini CLI와 함께하는 터미널(CLI) 명령어 학습하기

Gemini CLI와 함께하는 터미널(CLI) 명령어 학습하기