LoreConvo v0.10.6

당신의 기억은 도구가 아닌 정체성을 따릅니다 — 당신의 동의와 함께.

LoreConvo는 Claude Code, Cowork, Codex, Cursor, Hermes Agent 전반에 걸쳐 컨텍스트를 전달하는 유일한 AI 메모리입니다. 한 번 설치하면, 어디서 코딩하든 하나의 메모리가 적용됩니다.

Claude Code의 플러그인 마켓플레이스에서 직접 설치하거나 PyPI를 통해 설치하세요: uvx loreconvo

왜 LoreConvo인가?

어디서 작업하든 작동합니다

LoreConvo는 Claude Code, Cowork, Cursor, Codex, Hermes 전반에서 작동합니다 — 어떤 클라이언트를 사용하든 동일한 메모리 레이어가 적용됩니다. 프로젝트 중간에 전환해도 컨텍스트가 자동으로 함께 이동합니다.

대부분의 도구는 기계나 작업 공간별로 메모리를 격리합니다. LoreConvo는 모든 것을 당신이 소유한 SQLite 데이터베이스에 로컬로 저장하고, 어디에 있든 표시합니다. 캡처는 두 가지 방식으로 이루어집니다: 저장 도구를 통한 명시적 방식, 또는 선택적 후크를 설치한 경우 세션 종료 시 자동 방식입니다. 어느 쪽이든 언제든지 모든 메모리를 검사, 편집 또는 삭제할 수 있습니다.

저장되는 내용을 직접 제어합니다

LoreConvo는 당신에게 제어권을 부여합니다: 자동 캡처는 세션 후크를 설치하기로 선택한 경우에만 실행되며, 모든 저장은 검사 가능하고, 언제든지 모든 메모리를 삭제할 수 있습니다.

모든 메모리는 정확히 어디서 왔는지 표시합니다 — 어떤 표면에서 캡처했는지, 언제, 어떤 프로젝트 컨텍스트에 속하는지, 어떤 스킬이 생성했는지. 미스터리 없음. 완전한 출처 추적.

메모리는 당신의 기기에 남아 있습니다

LoreConvo는 모든 것을 당신의 기기에 있는 SQLite 데이터베이스에 저장합니다. 명시적으로 선택적 AI 요약 기능(Pro, 기본적으로 꺼짐)을 활성화하지 않는 한 데이터는 로컬에 유지됩니다. 이 기능은 당신의 키를 사용하여 세션 발췌문을 Anthropic API로 보냅니다. 클라우드 계정 없음. 세션 기록에 접근할 수 있는 공급업체 없음.

세션은 ~/.loreconvo/sessions.db에 저장됩니다 — 당신이 소유하고, 백업할 수 있고, 언제든지 삭제할 수 있는 파일입니다.

원시 대화 기록이 아닌 구조화된 메모리

LoreConvo는 각 세션에 대해 두 가지 유형의 메모리를 캡처합니다:

• 일화적 메모리: 무엇이 일어났는지 — 요약, 생성된 산출물, 남겨진 미해결 질문

• 의미적 메모리: 무엇이 결정되었는지 — 세션 간에 지속되는 프로젝트에 대한 안정적인 결론

이 둘을 함께 사용하면 Claude에게 프로젝트 기록의 구조화되고 검색 가능한 기록을 제공하며, 단순한 채팅 대화 기록 더미가 아닙니다.

Related MCP server: ai-memory

회상 벤치마크

LoreConvo의 FTS5 검색은 60개 세션 합성 코퍼스(6개 주제 영역, 36개 레이블링된 쿼리)를 기준으로 벤치마킹되었습니다.

복합 토큰 확장(camelCase / snake_case 쿼리 전처리)은 autoSave, pipeline_tracker, get_context_for 같은 기술 식별자를 사용하는 쿼리에서 Recall@5를 +35.7 pp 향상시킵니다.

전체 벤치마크 보고서 | 재현

빠른 시작

설치를 위한 한 가지 명령:

bash install.sh

이 명령은 가상 환경을 생성하고, 종속성을 설치하고, 모든 것이 작동하는지 확인합니다. 시스템 Python 변경 없음, 수동 pip 명령 없음.

LoreConvo 사용하기

Claude Code(터미널)

플러그인이 로드된 세션 시작:

claude --plugin-dir /path/to/loreconvo

또는 기존 세션 내에서 로드:

/plugin add /path/to/loreconvo

/path/to/loreconvo를 소스 폴더를 저장한 위치로 바꾸세요.

코드 변경 후에는 재시작 없이 /reload-plugins를 사용하여 새로고침하세요.

로드되면 Claude는 39개의 LoreConvo MCP 도구에 자동으로 액세스할 수 있습니다. Claude에게 "이 세션 저장" 또는 "X에 대해 논의한 내용 회상"을 요청하면 도구를 자체적으로 사용합니다.

Cowork(데스크톱 앱)

1. 프롬프트 상자 옆의 + 버튼을 클릭합니다

2. 플러그인 선택

3. 플러그인 추가 선택

4. loreconvo 소스 폴더로 이동

중요: 공유 데이터베이스 액세스

Cowork는 샌드박스 VM에서 실행되며 기본적으로 Mac의 파일 시스템을 볼 수 없습니다. Claude Code가 저장한 세션을 읽으려면 Cowork에서 Claude에게 요청하세요:

"내 ~/.loreconvo 폴더를 마운트해 줘"

마운트되면 Cowork는 Claude Code와 동일한 데이터베이스를 읽고 씁니다. Code에서 저장된 세션은 Cowork에 즉시 표시됩니다.

Claude Chat(웹)

Chat은 플러그인을 지원하지 않으므로 LoreConvo는 원커맨드 브리지를 제공합니다. 터미널에서 다음을 실행하세요:

bash export-to-chat.sh

이 명령은 마지막 세션을 내보내고 클립보드에 복사합니다(macOS). Chat으로 전환하여 붙여넣기(Cmd+V)하세요. Chat은 Code 또는 Cowork 세션의 컨텍스트를 즉시 갖게 됩니다.

특정 세션을 검색하려면:

bash export-to-chat.sh "tax prep"

여러 표면에서의 작동 방식

LoreConvo의 핵심 가치는 컨텍스트가 Claude 표면 간에 자동으로 유지된다는 것입니다. 전체 체인은 다음과 같습니다:

Claude Code  (~/.claude/settings.json via `claude mcp add`)
  |-- SessionEnd hook --> auto_save.py --> ~/.loreconvo/sessions.db
  |-- SessionStart hook <-- auto_load.py <-+
                                           |
Cursor       (.cursor/mcp.json) <--MCP-----+
Codex        (~/.codex/config.toml) <--MCP-+
Hermes Agent (~/.hermes/config.yaml) <-MCP-+
Cowork       (MCP-native execution env) <--+
  All surfaces: save_session / get_recent_sessions / search_sessions

Claude Chat (web)
  |-- export-to-chat.sh --> clipboard --> paste into Chat

Claude Code는 기본 표면입니다. 후크는 자동으로 실행됩니다:

• 세션이 종료되면 auto_save.py가 대화를 캡처하고 구조화된 요약(결정, 산출물, 미해결 질문, 태그)을 로컬 SQLite 데이터베이스에 저장합니다.

• 새 세션이 시작되면 auto_load.py가 데이터베이스를 쿼리하고, 신호 품질로 최근 세션의 점수를 매기고, 가장 관련성 높은 컨텍스트를 시스템 컨텍스트로 세션에 주입합니다. 미해결 질문과 결정이 있는 세션이 가장 높은 점수를 받고, 신호가 낮은 세션은 필터링됩니다. 또한 프로젝트 디렉토리에서 발견된 MEMORY.md를 인덱싱합니다(MEMORY.md 자동 인덱싱 참조).

Cursor는 프로젝트 루트의 .cursor/mcp.json을 통해 연결합니다 — Claude Code와 동일한 MCP 프로토콜입니다. 설정 세부 사항은 INSTALL.md를 참조하세요.

OpenAI Codex는 [mcp_servers.<name>] 섹션을 사용하여 ~/.codex/config.toml을 통해 연결합니다. 설정 세부 사항은 INSTALL.md를 참조하세요.

Hermes Agent는 mcp_servers: 키 아래의 ~/.hermes/config.yaml을 통해 연결합니다. 설정 세부 사항은 INSTALL.md를 참조하세요.

Claude Chat(웹)은 플러그인을 지원하지 않습니다. export-to-chat.sh 스크립트가 그 격차를 메웁니다: 가장 최근 세션을 클립보드로 내보내 Chat에 직접 붙여넣을 수 있습니다. 이렇게 하면 Chat은 Code가 자동으로 로드했을 동일한 컨텍스트를 갖게 됩니다.

결과: 프로젝트 중간에 표면을 전환해도 무엇을 하고 있었는지 다시 설명할 필요가 없습니다.

데이터는 항상 사용 가능합니다

LoreConvo는 MCP 도구를 사용할 수 있을 때 이를 통해 작동하고, 사용할 수 없을 때 번들 스크립트로 자동 대체합니다. MCP 상태와 관계없이 세션은 안전합니다 — 동일한 저장, 검색, 회상 작업이 어느 쪽이든 작동합니다. 아무것도 구성할 필요가 없습니다. 플러그인 스킬이 자동으로 전환을 처리합니다.

프로젝트 작업 공간

LoreConvo 프로젝트는 영구 작업 공간입니다 — 프로젝트 작업의 모든 세션, 결정, 산출물은 모든 Claude 표면에서 검색 가능합니다.

# Create a project workspace
create_project("my-api", "REST API project", expected_skills=["openapi", "python"])

# Add persistent project instructions (optional)
create_project(
    "my-api",
    description="REST API project",
    instructions="Python 3.10+, SQLite only. No cloud dependencies. Deploy via Docker."
)

# See recent sessions, skill usage, and open questions for the project
get_project("my-api")

# Search scoped to the project
search_sessions("auth design", project="my-api")

프로젝트 지침(선택 사항): 프로젝트를 생성할 때 세션 시작 시 Claude가 볼 영구 지침이나 제약 조건을 저장할 수 있습니다. 이는 모든 CLAUDE.md 파일에 반복하지 않고 프로젝트 전체 표준을 적용하는 데 유용합니다. 지침은 최근 세션 요약 앞의 자동 로드 컨텍스트에 표시됩니다.

LoreDocs와 함께 사용하면 LoreConvo는 모든 Claude를 위한 휴대용 프로젝트 작업 공간을 형성합니다 — 세션 메모리와 구조화된 지식, 전적으로 당신의 기기에서. 클라우드 AI 작업 공간이 하나의 생태계에 묶는 반면, Lore 페어는 이미 사용 중인 모든 Claude 표면에서 작동합니다.

MEMORY.md 자동 인덱싱

프로젝트에 MEMORY.md 파일이 있으면 LoreConvo는 모든 세션 시작 시 자동으로 인덱싱합니다. 내용은 search_sessions를 통해 일반 세션과 함께 검색 가능해집니다.

즉, Claude는 언급하지 않아도 MEMORY.md에서 프로젝트 규칙, 팀 메모 또는 아키텍처 결정을 회상할 수 있습니다. MEMORY.md의 검색 결과는 memory_md 태그와 source='file_memory'로 표시되어 일반 세션 항목과 구분할 수 있습니다.

어떤 디렉토리가 스캔되나요?

기본적으로 LoreConvo는 Claude Code가 실행 중인 디렉토리(현재 작업 디렉토리)를 스캔합니다. 다른 디렉토리를 지정하려면 claude mcp add --scope user 명령에 LORECONVO_PROJECT_PATH 환경 플래그로 전달하세요:

"--env=LORECONVO_PROJECT_PATH=/Users/YOUR_USERNAME/projects/my_project"

YOUR_USERNAME과 my_project를 실제 값으로 바꾸세요. 전체 절대 경로를 사용하세요 — ~ 또는 $HOME을 사용하지 마세요.

검색 결과에서 MEMORY.md 항목 필터링

검색에 MEMORY.md 항목을 포함하려면 search_sessions를 일반적으로 사용하세요 — 자동으로 나타납니다. MEMORY.md 항목만 보려면 태그로 필터링하세요:

"LoreConvo 세션에서 memory_md 태그가 있는 'database conventions'를 검색해 줘."

인덱스는 세션이 시작될 때마다 업데이트됩니다(멱등적 — 중복이 누적되지 않음).

설치 확인

설치 후 LoreConvo가 작동하는지 확인하려면 Claude에게 요청하세요:

"get_recent_sessions를 실행하고 결과를 보여줘."

세션 목록이 표시되면(처음이라면 빈 목록이어도) LoreConvo가 연결된 것입니다. 도구 누락 오류가 발생하면 bash install.sh를 다시 실행하고 플러그인을 새로고침하세요.

후크 확인(Claude Code 전용):

"이 세션 시작 시 LoreConvo가 컨텍스트를 자동 로드했는지 확인해 줘."

SessionStart 후크가 작동하면 Claude는 최근 세션의 컨텍스트를 자동으로 받았을 것입니다.

권장 CLAUDE.md 설정

최상의 경험을 위해 다음 스니펫을 ~/.claude/CLAUDE.md(전역) 또는 프로젝트의 CLAUDE.md에 추가하세요. 이는 Claude에게 세션 간에 LoreConvo를 일관되게 사용하는 방법을 알려줍니다.

## LoreConvo (persistent session memory)

At session start:
1. Call `get_recent_sessions` to check for recent context relevant to the current work.
2. Use this context to avoid re-explaining things already discussed in prior sessions.

During the session:
- If important decisions are made or domain knowledge is shared, note it for the session summary.

At session end:
- Call `save_session` with a summary of what was accomplished, key decisions, open questions,
  and any artifacts created. Use appropriate tags (e.g., project name, surface).

Cowork 사용자용: Cowork는 후크를 자동으로 실행하지 않습니다. 프로젝트 CLAUDE.md에 세션 시작 시 get_recent_sessions를 호출하고 세션 종료 시 save_session을 호출하는 지침을 추가하세요. 자세한 내용은 COWORK_RESTORE.md를 참조하세요.

요금제: 무료 vs Pro

LoreConvo는 로컬 우선이며 무료로 사용할 수 있습니다. Pro($8/월)는 세션 제한을 제거하고 LLM 품질 요약, 하이브리드 검색 검색, 교차 제품 연결을 잠금 해제합니다. 두 요금제 모두 모든 것이 당신의 기기에서 실행됩니다 — Pro는 클라우드 구성 요소를 추가하지 않습니다.

무료 티어 검색: 키워드(FTS5) + 최신순 정렬. Pro 티어 검색: 하이브리드 검색 — 벡터(BGE-small-en-v1.5), BM25 전체 텍스트, 최신순 재순위를 RRF 융합으로 결합. 키워드뿐만 아니라 의미로 세션을 찾습니다.

get_tier로 현재 티어와 사용량을 확인하세요. vault_set_tier로 Pro 라이선스를 활성화하세요.

기능

• 자동 세션 캡처: 세션은 Claude Code 훅을 통해 세션 종료 시 저장되고 세션 시작 시 로드됩니다. 수동으로 save_session을 호출할 필요가 없습니다.

• 클라이언트 간 메모리: 컨텍스트가 Claude Code, Cowork, Cursor, Codex, Hermes 전반에서 사용자를 따라다닙니다. 하나의 IDE나 머신에 국한되지 않습니다.

• 구조화된 세션: 단순 원문이 아니라 결정, 산출물, 미해결 질문을 캡처합니다. 선택적 reasoning_notes 필드에 에이전트 추론 체인을 저장합니다.

• 프로젝트 구성: 예상 스킬 세트와 함께 세션을 프로젝트별로 그룹화합니다.

• 스킬 추적: 스마트 필터링을 위해 사용된 스킬을 기록합니다.

• 페르소나 태깅: 에이전트별 메모리를 위한 계층적 페르소나 (예: ron-bot:sql)

• 전체 텍스트 검색: 모든 세션에 대한 빠른 키워드 검색을 위한 SQLite FTS5

• MEMORY.md 자동 인덱싱: 프로젝트의 MEMORY.md는 세션 시작 시 자동으로 인덱싱되며 search_sessions를 통해 일반 세션과 함께 검색할 수 있습니다.

• LLM 비동기 세션 요약 (Pro): 자동 저장된 세션은 백그라운드에서 Claude Haiku를 사용하여 LLM 수준의 요약으로 업그레이드됩니다. LORECONVO_ANTHROPIC_API_KEY를 설정하여 옵트인하세요. 일일 상한(LORECONVO_SUMMARIZER_DAILY_CAP, 기본값 100)이 API 비용 폭주를 방지합니다. Pro 티어 전용입니다.

• 임베딩 기반 관련 세션 발견 (Pro): get_related_sessions는 BGE-small-en-v1.5 임베딩(코사인 >= 0.75)을 사용하여 유사한 콘텐츠의 세션을 자동으로 발견합니다. 저장당 최대 10개의 양방향 자동 링크가 생성되며, 동일 프로젝트 범위로 제한됩니다. Free 티어는 키워드 동시 발생 링크를 얻습니다. LORECONVO_EMBEDDING_LINKS=0을 설정하면 임베딩 링크를 비활성화할 수 있습니다.

• 제품 간 문서 연결 (Pro): 모든 세션에 가장 관련성이 높은 LoreDocs 문서를 자동으로 발견하고 연결하며, 그 반대의 경우도 마찬가지입니다. get_docs_for_session 및 session_link_doc라는 두 가지 새 도구를 사용합니다. LoreConvo Pro와 LoreDocs Pro가 모두 필요합니다.

• 로컬 우선: SQLite 데이터베이스, 클라우드 의존성 없음, API 비용 제로

티어

Free - 50개 세션

• 전체 기능 세트: 자동 로드, 전체 텍스트 검색, 태깅, 세션 연결, 내보내기 및 가져오기

• 로컬 SQLite 저장소 -- 데이터는 내 머신에, 클라우드 계정 불필요

• Anthropic Marketplace를 통한 원클릭 설치

Pro - 월 $8

• 무제한 세션

• 팀 메모리: 동료와 세션 공유 (로컬 우선 비동기 내보내기/가져오기, 서버 불필요)

• 관련 세션 발견 및 시맨틱 검색

• Anthropic 관리 에이전트 내보내기

• 백그라운드에서 LLM 수준의 세션 요약 (비동기)

Pro로 업그레이드 -- 월 $8

MCP 도구

LoreConvo는 세션 중 Claude가 자동으로 호출하는 39개의 MCP 도구를 제공합니다. 아래 표는 가장 일반적으로 사용되는 도구를 보여줍니다. 전체 참조는 MCP 도구 카탈로그를 참조하세요.

요구 사항

• Python 3.10+

• macOS 또는 Linux

• mcp 및 click (install.sh에 의해 자동 설치됨)

데이터 및 개인정보 보호

LoreConvo는 로컬 우선입니다. 모든 데이터는 사용자 머신의 ~/.loreconvo/sessions.db에 저장됩니다.

• 수집되는 데이터: 저장 시 제공하는 세션 제목, 요약, 태그, 클라이언트 식별자, 프로젝트 이름 및 스킬 이름. 원격 측정, 사용 분석 또는 식별자는 자동으로 수집되지 않습니다.

• 저장소: ~/.loreconvo/sessions.db의 SQLite 데이터베이스. 클라우드 저장소 없음. LORECONVO_DB 환경 변수로 경로를 재정의할 수 있습니다.

• 제3자 공유: 기본적으로 없음. LORECONVO_ANTHROPIC_API_KEY를 설정하여 선택적 AI 요약(Pro)을 활성화하는 경우에만 데이터가 머신을 떠나며, 이 경우 제한된 대화 내용 발췌문이 사용자 자신의 키로 Anthropic API에 전송됩니다. 키를 설정하지 않으면 모든 것이 로컬에 유지됩니다.

• 보존: delete_session을 통해 삭제하거나 데이터베이스 파일을 수동으로 제거할 때까지 데이터가 보존됩니다. 자동 만료 없음.

• 연락처: info@labyrinthanalyticsconsulting.com

전체 개인정보 보호정책: https://labyrinthanalyticsconsulting.com/privacy

문제 해결

MCP 도구가 Claude Code에 표시되지 않나요?

먼저 bash install.sh를 실행했는지 확인하세요. .venv가 존재하고 종속성이 설치되어 있어야 합니다.

"No module named 'mcp'" 오류?

.mcp.json은 플러그인 폴더 안의 .venv/bin/python3을 가리킵니다. 폴더를 이동한 경우 bash install.sh를 다시 실행하세요.

Cowork에서 Code에 저장된 세션을 볼 수 없나요?

Cowork가 공유 데이터베이스에 액세스할 수 있도록 Claude에게 "내 ~/.loreconvo 폴더를 마운트해"라고 요청하세요.

대체 스크립트 (직접 DB 액세스)

MCP 서버에 연결할 수 없는 경우(예: 예약된 작업 또는 자동화 스크립트에서) scripts/save_to_loreconvo.py가 SQLite 데이터베이스에 대해 동일한 핵심 작업을 직접 제공합니다.

# Save a session
python scripts/save_to_loreconvo.py \
    --title "Daily QA run" \
    --surface "qa" \
    --summary "Ran full test suite. All passing." \
    --tags '["qa", "automated"]'

# Read recent sessions
python scripts/save_to_loreconvo.py --read --limit 5

# Filter by surface
python scripts/save_to_loreconvo.py --read --surface code --limit 3

# Search sessions
python scripts/save_to_loreconvo.py --search "tax pipeline"

스크립트는 ~/.loreconvo/sessions.db에서 데이터베이스를 자동으로 감지합니다(또는 --db-path를 명시적으로 전달하세요). 올바른 UUID를 생성하고 MCP save_session 도구와 동일한 스키마를 작성합니다.

새로운 기능

v0.10.6 (2026-08-19)

수정됨: 실패 알림이 포착해야 할 바로 그 중단 상황에서 침묵할 수 있었음

저장 훅이 시작을 마치기 전에 충분히 일찍 크래시하면 실패가 전혀 기록되지 않았고, 그래서 "자동 저장이 중단되었습니다" 알림은 포착해야 할 바로 그 상황에서 침묵했습니다. 이제 저장 훅은 이렇게 일찍 죽더라도 백업 경로를 통해 실패를 기록하므로, 알림은 스스로 보고할 만큼 진행된 실패 모드뿐만 아니라 모든 실패 모드에서 발동합니다.

전체 릴리스 내역은 변경 로그를 참조하세요.

라이선스

Business Source License 1.1 (BSL 1.1) - Labyrinth Analytics Consulting

개인/비상업적 용도(최대 50개 세션)에는 무료입니다. 상업적 사용에는 유료 라이선스가 필요합니다. 2030-03-31에 Apache 2.0으로 전환됩니다. 자세한 내용은 LICENSE를 참조하세요.