ChatGPT·Claude 대화 기록, 조사 자료, 일상 입력을 바탕으로 검색 가능한 Obsidian 지식 베이스를 구축하도록 안내하는 Claude Code skill입니다.
breferrari/obsidian-mind
Claude Code 같은 AI 코딩 에이전트가 세션을 넘어 지속적으로 기억하도록 돕는 Obsidian vault 템플릿입니다.
- 스타
- 5,509
- 포크
- 611
- 열린 이슈
- 16
- 마지막 커밋
- 21일 전
어떤 프로젝트인가요?
Obsidian Mind는 AI 코딩 에이전트가 장기 기억을 읽고 기록할 수 있도록 미리 구조를 잡아 둔 Obsidian vault입니다. 각 세션은 사용자의 목표, 진행 중인 프로젝트, 미완료 작업, 최근 git 변경 사항을 담은 맥락으로 시작하므로 에이전트가 아무것도 모르는 상태에서 출발하지 않습니다. 노트는 용도별 폴더에 저장되며 관련 인물, 결정 사항, 프로젝트와 연결됩니다.
이 프로젝트는 주로 Claude Code용으로 만들어졌으며, 동일한 스크립트와 vault를 사용하는 Codex CLI 및 Gemini CLI용 hook과 command 설정도 포함합니다. 라이프사이클 hook은 결정 사항, 사고, 1:1 미팅 등의 메시지를 분류하고, markdown을 작성할 때 frontmatter와 wikilink를 검증하며, 컨텍스트 압축 전에 세션 트랜스크립트를 백업합니다. 슬래시 명령어로 데일리 스탠드업, 생각 정리, 하루 마무리, 주간 종합, 리뷰 준비를 할 수 있습니다.
선택 사항인 QMD 통합은 vault에서 로컬 시맨틱 검색을 제공하고, 이를 MCP 서버를 통해 에이전트에 노출합니다. 같은 서버를 등록하면 다른 저장소의 세션에서도 vault를 조회할 수 있습니다.
핵심 기능
- 01세션 시작 시 North Star 목표, 진행 중인 프로젝트, 미완료 작업, 최근 git 변경 사항을 불러옵니다.
- 02메시지를 결정 사항, 사고, 성과, 미팅으로 분류해 서로 연결된 노트로 저장합니다.
- 03markdown 노트를 작성할 때마다 frontmatter와 wikilink를 검증합니다.
- 04컨텍스트 압축 전에 세션 트랜스크립트를 백업합니다.
- 05스탠드업, 하루 마무리, 주간 종합, 리뷰 브리프용 슬래시 명령어를 제공합니다.
- 06QMD와 MCP 서버를 통한 로컬 시맨틱 검색을 선택적으로 제공합니다.
활용 사례
- AI 코딩 에이전트가 며칠 또는 몇 주에 걸쳐 진행 중인 프로젝트와 과거 결정을 파악하도록 합니다.
- 성과 리뷰에 활용할 수 있도록 1:1 미팅, 사고, 성과를 서로 연결된 노트로 기록합니다.
- Obsidian을 코딩 에이전트가 조회하고 업데이트할 수 있는 개인 지식 베이스로 사용합니다.
빠른 시작
- 1
ShardMind를 전역으로 설치합니다
npm install -g shardmind - 2
vault용 빈 폴더를 만들고 해당 폴더로 이동합니다
mkdir my-vault && cd my-vault - 3
ShardMind로 vault 템플릿을 설치합니다
shardmind install github:breferrari/obsidian-mind - 4
Obsidian에서 폴더를 vault로 열고 해당 디렉터리에서 에이전트(예: Claude Code)를 실행합니다
claude
사용 전 알아둘 점
- 완전한 지원은 Claude Code에만 제공됩니다. Codex CLI와 Gemini CLI에서는 hooks와 commands를 사용할 수 있지만 기능이 더 적습니다.
- Obsidian CLI 통합을 사용하려면 Obsidian 1.12 이상이 필요합니다.
- 선택 사항인 QMD 시맨틱 검색을 처음 사용할 때 로컬 모델 약 2.3 GB를 다운로드합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- obsidian-mind은(는) 무엇인가요?
- Claude Code 같은 AI 코딩 에이전트가 세션을 넘어 지속적으로 기억하도록 돕는 Obsidian vault 템플릿입니다. Obsidian Mind는 AI 코딩 에이전트가 장기 기억을 읽고 기록할 수 있도록 미리 구조를 잡아 둔 Obsidian vault입니다. 각 세션은 사용자의 목표, 진행 중인 프로젝트, 미완료 작업, 최근 git 변경 사항을 담은 맥락으로 시작하므로 에이전트가 아무것도 모르는 상태에서 출발하지 않습니다. 노트는 용도별 폴더에 저장되며 관련 인물, 결정 사항, 프로젝트와 연결됩니다.
- obsidian-mind은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- obsidian-mind은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- obsidian-mind은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. obsidian-mind의 마지막 커밋은 2026년 10월 17일입니다.
- obsidian-mind은(는) 어디에 사용할 수 있나요?
- AI 코딩 에이전트가 며칠 또는 몇 주에 걸쳐 진행 중인 프로젝트와 과거 결정을 파악하도록 합니다. 성과 리뷰에 활용할 수 있도록 1:1 미팅, 사고, 성과를 서로 연결된 노트로 기록합니다. Obsidian을 코딩 에이전트가 조회하고 업데이트할 수 있는 개인 지식 베이스로 사용합니다.
- obsidian-mind는 어떻게 설치하나요?
- ShardMind를 전역으로 설치합니다: npm install -g shardmind vault용 빈 폴더를 만들고 해당 폴더로 이동합니다: mkdir my-vault && cd my-vault ShardMind로 vault 템플릿을 설치합니다: shardmind install github:breferrari/obsidian-mind Obsidian에서 폴더를 vault로 열고 해당 디렉터리에서 에이전트(예: Claude Code)를 실행합니다: claude
- obsidian-mind은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/breferrari/obsidian-mind
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Telegram으로 음성 메모와 메시지를 받아 Obsidian vault에 유형별로 분류된 상호 연결 Markdown 카드로 저장하는 셀프 호스팅 개인 에이전트입니다.
Obsidian vault에서 채팅으로 노트, 이메일, 캘린더, 회의록을 관리하는 AI 에이전트 8개와 스킬 14개
Claude Code, Codex 및 기타 AI 에이전트를 위한 영구 메모리로, Obsidian vault에 일반 Markdown으로 저장합니다.
Claude Code와 Obsidian에서 AI 에이전트가 링크형 마크다운 지식 베이스를 만들고 관리하도록 돕는 스타터 vault, 가이드, 스킬 및 스크립트입니다.
Obsidian을 Astro 사이트의 콘텐츠 편집기로 사용하는 헤드리스 CMS로, Markdown 파일을 콘텐츠의 기준으로 삼습니다.