콘텐츠로 이동
MiniCITY Docs

Hindsight embed 기능 개요 및 연동 가이드

Hindsight embed 기능 개요 및 연동 가이드

섹션 제목: “Hindsight embed 기능 개요 및 연동 가이드”

[!note] 수정이력 | 2026-05-07 17:40, 루키 (hermes)

  • 최초 작성. hindsight-embed의 3대 연동 영역(옵시디언, Git/Gitea, Hermes 추가 기능)을 정리.

1. hindsight-embed 이란

섹션 제목: “1. hindsight-embed 이란”

Hermes Agent의 지속 기억(persistent memory) 시스템.
대화 중 저장한 정보를 검색·추론하고, 웹 GUI(Constellation/Graph/Table/Timeline)로 시각화할 수 있음.

2. 옵시디언(Obsidian) 연동

섹션 제목: “2. 옵시디언(Obsidian) 연동”
연동 방향설명
기록 저장hindsight_retain으로 저장한 내용 → 옵시디언 볼트 01_PROJECTS/D-1_자료정리(wiki)/에 작업 로그로 등록
작업 추적에이전트가 수행한 설정/테스트/에러 등을 md 파일로 보관 → 옵시디언 그래프 뷰에서 히스토리 확인
파일명 규칙YYYYMMDD_HHMM_제목.md 형식, 태그는 [hindsight, hermes, ...]
  • 볼트 경로: 01_PROJECTS(프로젝트)/D-1_자료정리(wiki)/
  • 관련 문서:
    • 20260506_2016_Hermes_Hindsight_로컬_임베디드_설치_매뉴얼.md
    • 20260506_2236_Hermes_Hindsight_설치_및_설정_완료.md

3. Git / Gitea 연동

섹션 제목: “3. Git / Gitea 연동”
항목설명
스킬 버전 관리~/.hermes/skills/ 변경사항 → Git 커밋/푸시로 버전 기록
참조 문서 동기화hindsight-embed 사용법, Caddy 설정법 등 → references/*.md로 보관 후 Gitea 백업
에이전트 설정 공유config.yaml, CLAUDE.md, AGENTS.md 등 팀/기기 간 동기화

4. Hermes 추가 기능

섹션 제목: “4. Hermes 추가 기능”

4-1. 기본 3기능 (CLI/API)

섹션 제목: “4-1. 기본 3기능 (CLI/API)”
기능명령어/도구역할
저장hindsight_retain대화 중 중요 정보를 메모리 뱅크에 저장
검색hindsight_recall키워드/의미 기반으로 과거 기억을 찾음
추론hindsight_reflect저장된 사실들을 종합하여 추론 답변 생성

4-2. Control Plane GUI 대시보드

섹션 제목: “4-2. Control Plane GUI 대시보드”
항목내용
실행hindsight-embed -p hermes ui start --port 19177
종료hindsight-embed -p hermes ui stop
로컬 주소http://127.0.0.1:19177/dashboard
외부 주소https://ruki-r.pinksky.kr/dashboard
메뉴Memories / Recall / Reflect / Documents / Entities / Bank Configuration
메모리 타입World Facts / Experience / Observations / Mental Models
뷰 모드Constellation(별자리) / Graph / Table / Timeline

4-3. Caddy 리버스 프록시 등록

섹션 제목: “4-3. Caddy 리버스 프록시 등록”
  • 서브도메인: ruki-r.pinksky.kr
  • 타겟: 127.0.0.1:19177
  • 인증서: HTTPS 자동 발급 (Caddy + Let’s Encrypt)
  • 헬스체크: agent.pinksky.kr 대시보드에 포함 (status: online, ~20ms)

5. 참고 명령어 모음

섹션 제목: “5. 참고 명령어 모음”
Terminal window
# 데몬 상태 확인
hindsight-embed daemon --profile hermes status


# UI 실행 (로컬 19177)
hindsight-embed -p hermes ui start --port 19177


# UI 종료
hindsight-embed -p hermes ui stop


# 메모리 직접 저장 (에이전트 내부)
hindsight_retain(content="...", context="...", tags=["..."])


# 메모리 검색 (에이전트 내부)
hindsight_recall(query="...")


# 추론 (에이전트 내부)
hindsight_reflect(query="...")

6. 관련 링크

섹션 제목: “6. 관련 링크”