AgriciDaniel/claude-obsidian

★ 11,589오늘 +272Python

Claude Code로 Obsidian 노트를 관리하는 개인 지식 시스템, 파일은 항상 사용자 손에

claude-obsidian은 Claude Code와 연동해 자료를 읽고 요약해서 Obsidian 볼트(마크다운 파일 모음)에 정리해주는 오픈소스 도구다. 저장, 근거 확인, 연결, 재활용까지 반복 가능한 흐름으로 지식을 쌓고, 모든 변경은 검토 후 승인해야 적용되는 안전장치를 갖고 있다. 카파시가 제안한 LLM Wiki 패턴을 기반으로 만들어졌다.

무엇을 하는 레포인가

무엇을: 아무 자료(문서, 웹페이지 등)를 넣으면 Claude가 읽고 서로 연결된 지식 그래프 형태의 마크다운 노트로 정리해준다
어떻게: inbox에 자료를 넣고 wiki-ingest 명령으로 인입하면 근거(소스)를 남긴 채 링크된 페이지로 만들고, wiki-query로 볼트 안 근거만 가지고 답을 낸다
안전장치: 모든 쓰기 작업은 계획을 먼저 검토하고 SHA-256 해시로 승인한 뒤에만 실제로 적용되며, 중간에 끊기면 이전 상태로 복구된다
구조: 15개의 스킬(기능 단위)로 나뉘어 있고 wiki, save, wiki-lint, wiki-retrieve, canvas 등이 각각 초기화, 저장, 점검, 검색, 시각화를 담당한다
결과: 볼트는 항상 평범한 마크다운 파일로 남아 클라우드에 종속되지 않고, 근거 없는 주장은 숨기지 않고 그대로 드러나게 설계됐다

왜 중요한가

AI에게 노트를 맡기면서도 원본 파일 소유권과 근거 추적을 잃지 않으려는 사람에게 실질적인 대안이 된다. 노트 앱을 클라우드에 맡기지 않고 로컬에서 스스로 관리하는 '두 번째 뇌'를 만들고 싶은 개발자나 연구자에게 참고가 될 구조다.

이 레포의 용어

Obsidian · 마크다운 파일을 노트로 관리하고 서로 링크해 그래프로 보여주는 로컬 노트 앱
볼트(vault) · Obsidian이 사용하는 노트 파일들이 들어있는 폴더 전체
BM25 · 키워드 일치를 기반으로 문서를 검색하는 전통적인 검색 알고리즘
SHA-256 · 데이터를 고정된 길이의 값으로 변환해 변경 여부를 검증하는 해시 함수
Agent Skills · AI 에이전트가 특정 작업을 수행하도록 정의된 기능 모듈 규격

레포 원문 소개 (영문)

Self-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

AgriciDaniel/claude-obsidian

무엇을 하는 레포인가

왜 중요한가

이 레포의 용어

주목받는 레포

METAL LAB 최신 기사