obsidian-vault-sync — Claude Code 대화 기록을 Obsidian 마크다운으로 자동 변환하는 도구

이 글은 Claude Code의 로컬 .jsonl 대화 기록을 읽어 Obsidian 마크다운으로 자동 변환하는 파이썬 도구를 공개한 게시물이다. 작성자는 세션 간 문맥 소실 문제를 해결하기 위해 로컬 트랜스크립트를 파싱해 노트로 저장하는 워크플로를 구현했고 GitHub 저장소를 통해 코드를 공개했다. 도구는 파이썬 전용으로 외부 유료 의존성이 없으며 cron이나 launchd로 스케줄링해 자동 동기화를 수행하도록 설계되었다.

분류는 모델 API 호출을 전혀 사용하지 않는 가중치 기반 키워드 매칭으로 작동하며 구체적으로 대화 제목에 오프닝 프롬프트보다 3배 높은 가중치를 부여해 세션 중요도를 판별한다. 추가 기능으로 Claude의 메모 폴더를 Obsidian 볼트에 심볼릭 링크해 모델이 유지하는 메모를 편집 가능한 노트로 노출시키는 메커니즘이 포함되어 있다. 커뮤니티 피드백을 반영해 Vault-worthy 플래그를 도입해 사용자가 동기화할 세션을 사전 표시할 수 있게 했고 현재 구현은 Claude에서 Obsidian으로의 일방향 정적 스냅샷을 생성하는 방식이다.

이 도구는 비용 제약이 있는 개인 워크플로에서 API 호출 없이 자동 보존을 구현하는 현실적 방안이 되며 메모리 심볼릭 링크를 통해 모델 내부 정보의 가시성을 확보할 수 있다. 다만 현재는 양방향 실시간 동기화가 지원되지 않아 진행 중인 대화를 실시간으로 반영하지 못하는 한계가 존재하며 심볼릭 링크로 노출되는 파일의 보안·프라이버시 영향도 검토해야 한다. 작성자는 해당 저장소를 유지보수하겠다고 밝혔고 분류 작동 방식에 대한 추가 질문을 환영한다고 표명했다.