Gemini-cli: Custom Slash Command 만들기

이 문서는

Gemini CLI에서

슬래시(/)로 시작하는 custom slash command 정의하고 사용하는 방법을 기술.

---

1. Overview

• Custom slash command 를 추가하면
• 복잡한 프롬프트를 짧은 명령어로 저장해 두고 필요할 때마다 호출할 수 있음.

예를 들어 /review "초보자"와 같은 형식으로 코드 리뷰를 요청할 수 있음.

---

2. 저장 위치 (Storage Locations)

Custom slash command 의 정의(or 설정) 파일(.toml)은 다음 두 위치 중 하나에 저장 가능함:

• Global Commands (All projects): ~/.gemini/commands/
• Local Commands (Project-specific): .gemini/commands/ (Relative to project root)

우선순위는 Local commands가 보다 높음.

---

3. 파일 형식 및 구조 (File Format and Structure)

파일 이름이 곧 명령어 임.

• explain.toml 파일인 경우, /explain 명령어를 생성.
• 하이픈(-)과 언더바(_), 영어 소문자로 파일명을 만들 것 (강력권장)

---

예시: /review.toml 파일 내용

description = "코드를 수준별로 리뷰."

prompt = """
제공된 코드를 리뷰해.
대상 수준: {{args}}

초보자라면 쉬운 용어로, 중급자라면 성능과 아키텍처 위주로 설명할 것.
모든 답변은 한국어로 작성해야 함.
"""

• description: /help 명령어 실행 시 표시될 명령어의 설명.
• prompt: 명령어 실행 시 AI에게 전달될 실제 프롬프트.
• {{args}}: 명령어 뒤에 입력하는 인자(argument)가 치환될 위치.
  • 예: /review "초보자" 실행 시 {{args}}는 "초보자"로 치환.

참고로 복수개의 인자를 집어넣어도 {{args}} 하나에 들어감(공백문자 포함하여).

---

4. Grouping Commands with Subdirectories

commands 디렉토리 안에 서브 디렉토리를 만들고,

해당 서브 디렉토리 밑에 비슷한 성격의 명령어들을 모아놓는 방식으로 namespace 형태의 관리가 가능함.

이때 서브 디렉토리의 이름을 namespace로 사용하고, 해당 서브디렉토리 명과 명령어 사이엔 구분자로 colon (:)을 사용함.

 

다음의 예를 확인할 것.

• ~/.gemini/commands/test.toml -> /test
• .gemini/commands/git/commit.toml -> /git:commit
• .gemini/commands/review/beginner.toml -> /review:beginner
• .gemini/commands/review/performance.toml -> /review:performance

이 같은 방식으로 namespace를 사용할 경우의 장점은 다음과 같음.

• 관련 명령어를 주제별로 정리 가능함.
• 명령어 수가 많아져도 파일 관리가 쉬워짐.
• 이름 충돌을 줄이기 쉬움.

---

5. 적용 및 사용

명령어 새로고침 (Reload Commands)

• 새로운 파일을 생성하거나 수정했다면,
• CLI 세션 내에서 다음 명령어를 실행하여 변경 사항을 적용:

/commands reload

명령어 사용 (Use the Command)

이후 다음과 같이 정의한 slash command를 사용할 수 있음:

/review "초보자"

---

같이 보면 좋은 자료들

2026.03.26 - [utils] - Gemini-cli: slash command

Gemini-cli: slash command

 

https://geminicli.com/docs/cli/custom-commands/

Custom commands