obsidian-second-brain은 Obsidian vault를 Claude Code, Codex CLI, Gemini CLI, OpenCode에서 함께 쓰는 AI-first 지식 시스템으로 바꾸는 오픈소스 프로젝트다. Karpathy의 LLM Wiki 패턴을 개인 vault에 적용하되, 새 노트를 계속 추가하는 수준을 넘어 기존 페이지를 갱신하고 모순을 조정하는 방향을 강조한다.
핵심 아이디어
기존 Obsidian + LLM 사용은 대개 “대화 내용을 요약해서 노트에 저장”에 머문다. obsidian-second-brain은 이를 명령어 기반 운영 시스템으로 확장한다.
| 기능 영역 | 설명 |
|---|---|
| ingest | URL, YouTube, 음성, 이미지, 회의 기록을 읽고 관련 노트 갱신 |
| reconcile | 서로 충돌하는 주장과 낡은 사실을 찾아 조정 |
| synthesize | 여러 소스에서 반복되는 패턴을 새 synthesis 페이지로 정리 |
| daily/weekly | 일정, 할 일, 최근 변화, vault 건강 상태를 주기적으로 점검 |
| export/context | 다른 AI 도구가 읽을 수 있는 vault snapshot 생성 |
README는 “append-only”가 아니라 “rewrite existing pages”를 차별점으로 내세운다. 사람, 프로젝트, 개념 노트가 새 소스에 의해 계속 갱신되어야 지식 베이스가 누적된다는 관점이다.
지원 환경
하나의 코드베이스가 여러 CLI에서 동작하도록 설계됐다.
| CLI | 의미 |
|---|---|
| Claude Code | 원래 사용 환경, .claude 명령과 스킬 중심 |
| Codex CLI | OpenAI Codex 환경에서 같은 vault 운영 |
| Gemini CLI | Gemini 기반 터미널 에이전트와 연동 |
| OpenCode | 오픈소스 코딩 에이전트 환경에서 사용 |
AI-first validator, 다국어 trigger schema, role preset, scheduled agents 등을 포함해 단순 명령 모음보다 운영 체계에 가깝다.
Karpathy LLM Wiki와의 차이
| 항목 | Karpathy식 LLM Wiki | obsidian-second-brain |
|---|---|---|
| 새 소스 처리 | 새 페이지 생성과 링크 | 기존 사람·프로젝트·개념 페이지 갱신 |
| 모순 처리 | 사람이 확인 | /obsidian-reconcile로 조정 |
| 패턴 발견 | 사용자가 질문할 때 | /obsidian-synthesize로 능동 탐색 |
| 실행 시점 | 온디맨드 | nightly close, weekly review 등 scheduled agents |
| 노트 형식 | 사람 읽기 중심 | future-agent가 검색하기 쉬운 frontmatter와 preamble 강조 |
어디에 적합한가
- Obsidian을 개인 운영체제처럼 쓰고 싶은 연구자·창작자
- Claude Code와 Codex를 지식 관리에도 활용하려는 개발자
- 회의, X, YouTube, 웹 리서치를 한 vault로 통합하고 싶은 사용자
- append-only 노트가 아니라 기존 지식을 계속 갱신하는 LLM Wiki 패턴을 실험하려는 팀
주의점
자동 갱신형 지식 시스템은 편하지만, 잘못된 요약이나 과도한 재작성으로 중요한 뉘앙스가 사라질 수 있다. README가 말하는 “future Claude” 중심 노트 형식도 인간 독서성보다 에이전트 검색성을 우선할 수 있다. 중요한 결정과 사실은 원문 링크, 인용, 변경 이력, 수동 리뷰 기준을 함께 두는 편이 안전하다.
관련 문서
- claude-obsidian — Claude Code와 Obsidian을 결합한 자기조직화 지식 베이스
- llm-wikid — AI가 유지하는 Karpathy 스타일 Obsidian 지식 베이스
- llm-knowledge-base — raw 소스를 구조화된 위키로 컴파일하는 패턴
- agentic-memory — AI 에이전트의 외부 영속 메모리 계층
참고 자료
- eugeniughelbur/obsidian-second-brain — GitHub 공식 저장소