Gemini CLI에서 Session Management를 사용해 중단한 지점부터 정확히 이어가기

Source: Google Developers Blog

DEC. 10, 2025

Editor’s Note: 이 새로운 기능은 Gemini CLI 커뮤니티의 뛰어난 오픈‑소스 기여자 Christopher Beeson 덕분에 가능해졌습니다. 9개 이상의 정교하게 작성된 풀 리퀘스트에 걸친 그의 세심한 작업이 이 기능을 실현하는 데 핵심이었습니다.

Context is everything when working with Gemini CLI. Whether you are refactoring a complex codebase or debugging a tricky error, your conversation history contains valuable reasoning, tool outputs, and decisions.

Gemini CLI를 사용할 때 컨텍스트가 모든 것입니다. 복잡한 코드베이스를 리팩터링하든, 까다로운 오류를 디버깅하든, 대화 기록에는 귀중한 추론, 도구 출력, 그리고 결정이 담겨 있습니다.

Previously, closing your terminal meant losing that context. Starting over required re‑explaining the problem to the model. This is no longer the case—Gemini CLI now automatically saves your sessions and lets you search through your session history to resume right where you left off!

자동 저장: 안심

Gemini CLI와 상호 작용할 때마다 세션이 자동으로 백그라운드에 저장됩니다. 채팅을 저장하거나 내보내는 것을 기억할 필요가 없습니다; 새로운 Session Management 시스템이 이를 대신 처리합니다.

우리는 작업의 전체 상태를 캡처합니다, 여기에는 다음이 포함됩니다:

• 프롬프트와 모델의 응답.
• 모든 도구 실행(입력 및 출력).
• 토큰 사용 통계.
• 어시스턴트 생각 및 추론 요약.

특히, 이러한 세션은 프로젝트별입니다. 다른 프로젝트 디렉터리로 전환하면 Gemini CLI가 자동으로 해당 프로젝트의 세션 기록으로 컨텍스트를 전환하여, Gemini CLI가 항상 여러분과 같은 페이지에 있도록 합니다.

Source:

세션 재개

이전 작업 흐름으로 다시 뛰어들기가 매우 쉬워졌습니다. 명령줄 플래그를 사용하든 인터랙티브 UI를 사용하든 선택은 자유입니다.

인터랙티브 세션 브라우저

Gemini CLI에서 /resume을 입력하면 새로운 세션 브라우저가 열립니다.

이 인터랙티브 인터페이스를 통해 할 수 있는 일:

• 탐색: 과거 세션을 시간 순으로 정렬한 목록을 스크롤합니다.
• 미리 보기: 메시지 수와 한 줄 요약 등 세부 정보를 확인하여 적절한 채팅을 찾습니다.
• 검색: /를 눌러 세션 ID 또는 내용 키워드로 필터링합니다.
• 선택: Enter를 눌러 해당 대화의 전체 컨텍스트를 즉시 복원합니다.

명령줄 파워

플래그를 선호하는 사용자라면 Gemini CLI를 시작할 때 바로 세션을 재개할 수 있습니다.

• 가장 최근 세션 재개: gemini --resume은 가장 최근 세션을 즉시 로드합니다.
• 특정 세션 재개: gemini --resume 5 (인덱스로) 또는 gemini --resume <session‑id> (세션 ID로) 사용합니다.

현재 프로젝트에 사용할 수 있는 모든 세션을 나열할 수도 있습니다:

gemini --list-sessions

출력 예시:

Available sessions for this project (3):

  1. Fix bug in auth (2 days ago) [a1b2c3d4]
  2. Refactor database schema (5 hours ago) [e5f67890]
  3. Update documentation (Just now) [abcd1234]

히스토리 관리

큰 힘에는 큰 책임이 따르듯… 혹은 이 경우, 많은 히스토리 파일이 따라옵니다! 환경을 깔끔하게 유지할 수 있도록 도구를 추가했습니다.

히스토리가 무한히 늘어나는 것을 방지하려면 settings.json 구성 파일에서 자동 정리 정책을 활성화할 수 있습니다:

{
  "general": {
    "sessionRetention": {
      "enabled": true,
      "maxAge": "30d",   // 세션을 30일 동안 보관
      "maxCount": 50     // 가장 최근 50개의 세션을 보관
    }
  }
}

Gemini CLI 사용량 추적

상세한 메시지, 생각, 도구 호출 및 토큰 사용 정보가 자동으로 기록되어 Gemini CLI 사용량을 분석할 수 있습니다. 커뮤니티에서 개발한 도구인 Splitrail와 같은 도구를 사용하거나 직접 개발할 수 있습니다.

오늘 시작하세요

Gemini CLI에서 세션 관리가 제공되며 **v0.20.0+**부터 기본적으로 활성화됩니다.

새로운 기능을 활용하려면 최신 버전으로 업데이트하세요:

npm install -g @google/gemini-cli@latest

자세한 내용은 세션 관리에 대한 공식 문서를 확인하세요.

또한 최신 뉴스와 공지를 놓치지 않으려면 Gemini CLI on X를 팔로우할 수 있습니다.