Tutorial 8: Session Management

튜토리얼 8: 세션 관리

터미널을 닫았다가 Hermes와의 멋진 대화를 잃어버린 적 있으신가요? 아니면 어제 고민하던 그 까다로운 버그 수정을 이어서 하고 싶었던 적은요? 좋은 소식이 있습니다: Hermes는 모든 것을 기억합니다. 모든 대화는 자동으로 세션으로 저장되며, 이 튜토리얼에서는 그 슈퍼파워를 활용하는 방법을 알려드리겠습니다.

세션은 어떻게 작동하나요?

세션은 이름표가 붙은 채팅 로그라고 생각하면 됩니다. CLI, 텔레그램, 디스코드, 슬랙, 왓츠앱, 그리고 그 외 20개 이상의 지원 플랫폼 중 어디에서 Hermes와 대화하든, 모든 대화는 전체 기록과 함께 저장됩니다.

이 모든 것은 ~/.hermes/state.db의 SQLite 데이터베이스에 저장됩니다. 각 세션에 대해 Hermes는 다음을 추적합니다:

• 고유하고 사람이 읽을 수 있는 제목
• 사용한 플랫폼 (CLI, 텔레그램 등)
• 모델 및 구성
• 도구 호출과 결과를 포함한 전체 메시지 기록
• 토큰 수 및 타임스탬프
• 상위 세션 ID (긴 대화가 분할될 때 사용)

실제로 컨텍스트에 포함되는 것

여기 흔한 오해가 하나 있습니다: Hermes는 여러분이 공유한 모든 파일이나 이미지를 다시 읽지 않습니다. 미디어는 턴 단위로 처리됩니다. 이미지를 보내고 밈을 요청하면, Hermes는 비전으로 한 번 분석한 후, 이후 턴에는 텍스트 설명이나 로컬 경로만 전달합니다 — 원본 JPEG는 아닙니다.

실제 컨텍스트를 많이 차지하는 것은 장황한 텍스트입니다: 붙여넣은 대화록, 거대한 로그, 큰 diff 등이요. 문서에는 좋은 팁이 있습니다: 대용량 아티팩트를 채팅에 복사하는 대신 요약, 파일 경로, 핵심 발췌문을 선호하세요.

CLI에서 대화 재개하기

여기가 마법이 일어나는 곳입니다. 중단했던 지점부터 이어서 시작하는 세 가지 방법을 살펴보겠습니다.

1. 마지막 세션 계속하기:

hermes --continue
# 또는 더 짧게
hermes -c

이 명령은 가장 최근 CLI 세션을 가져와 전체 기록을 로드합니다.

2. 터미널별 계속하기 (새롭고 멋진 기능입니다):

단독 -c는 이제 터미널을 인식합니다. Hermes는 각 터미널 세션에 대해 작은 브레드크럼 파일을 남깁니다. 따라서 두 개의 터미널 창을 나란히 열어두면, 각각 자신의 대화를 재개합니다 — 같은 대화를 두고 서로 충돌하지 않습니다. 창 간 크로스토크는 이제 없습니다!

브레드크럼이 없는 경우(첫 사용이거나 30일 이상 지난 경우), 가장 최근 세션으로 대체됩니다. config.yaml에서 session.terminal_continue: false로 이 기능을 비활성화할 수 있습니다.

3. 이름으로 재개하기:

세션에 의미 있는 제목을 붙여두면 바로 돌아갈 수 있습니다:

hermes -c "my project"

“my project”, “my project #2” 등과 같은 계열 변형이 있으면, Hermes는 자동으로 가장 최근 것을 가져옵니다.

특정 세션 재개하기

특정 대화로 돌아가야 하나요? 세션 ID를 사용하세요:

hermes --resume 20250305_091523_a1b2c3d4
# 또는 제목으로
hermes --resume "refactoring auth"
# 또는 그냥 최신 것으로
hermes --resume latest

문서에서 얻은 프로 팁

• /compress — 세션이 너무 길어졌을 때 사용하세요. 활성 컨텍스트를 줄여줍니다 (참고: 개인정보 삭제는 아닙니다).
• /new payments-refactor — 바로 제목이 있는 새 스레드를 시작하여 나중에 /resume으로 쉽게 찾을 수 있게 합니다.
• hermes sessions prune — 오래된 종료 세션을 삭제하고 싶을 때만 사용하세요.
• hermes sessions optimize — state.db가 단순히 큰 경우, 검색 인덱스를 병합하고 데이터를 건드리지 않고 정리합니다. 이걸 먼저 시도하세요!

마무리

세션 관리는 여러분의 기억 슈퍼파워입니다. 여러 터미널에서 여러 프로젝트를 동시에 처리하든, 일주일 전의 디버깅 세션을 다시 이어가든, Hermes가 도와드립니다. 핵심 요점: 긴 대화에는 /compress를 사용하고, /new <이름>으로 세션 이름을 지정하며, 터미널 인식 -c로 창을 정리하세요.

즐거운 채팅 되세요!

---