Ar9av/obsidian-wiki

당신의 AI 에이전트와 함께 성장하는 **디지털 브레인 (digital brain)**입니다. 당신이 알아낸 것을 기억하고, 이미 알고 있는 것과 연결하며, 질문할 때 답변합니다.

이 패턴은 Andrej Karpathy의 LLM Wiki gist에서 유래되었습니다: LLM에게 똑같은 질문을 반복해서 던지거나 (또는 매번 RAG를 실행하는 대신) 지식을 상호 연결된 마크다운 (markdown) 파일로 한 번 컴파일하고 이를 최신 상태로 유지하는 방식입니다. Obsidian은 그 브레인을 시각화하는 방법이며, 당신의 AI 에이전트는 그것을 성장시키는 방법입니다.

우리는 그 아이디어를 바탕으로 프레임워크를 구축했습니다. 모든 기술 (skill)은 모든 AI 코딩 에이전트 (Claude Code, Cursor, Windsurf, Pi 등)가 읽고 실행할 수 있는 마크다운 (markdown) 파일입니다. 에이전트를 Obsidian 보관함 (vault)으로 지정하고 무엇을 기억할지 알려주면, 그 보관함은 당신이 소유한 제2의 뇌가 됩니다.

pip install obsidian-wiki
obsidian-wiki setup --vault /path/to/your/digital/brain

obsidian-wiki setup은

~/.obsidian-wiki/config에 설정을 작성하며

모든 위키 기술 (wiki skill)을 당신의 모든 AI 에이전트 (Claude Code, Cursor, Codex, Gemini, Hermes, Pi 등)에 설치합니다. 기술들은 설치된 패키지에 심볼릭 링크 (symlinked)로 연결되어 있으므로, pip install -U obsidian-wiki를 통해

모든 곳에서 업그레이드할 수 있습니다. 새로운 기술을 적용하려면 obsidian-wiki setup을

다시 실행하기만 하면 됩니다. 그런 다음 에이전트에서 프로젝트를 열고 **"set up my wiki"**라고 말하세요.

obsidian-wiki list # 번들로 포함된 기술 목록 표시
obsidian-wiki info # 설치 경로, 버전 및 설정 표시
obsidian-wiki setup --project . # 현재 리포지토리에 프로젝트 로컬 기술 + AGENTS.md도 추가
...

OBSIDIAN_VAULT_PATH는

당신의 디지털 브레인이 위치하기를 원하는 디렉토리로, 새로운 빈 폴더나 기존의 Obsidian 보관함 (vault) 모두 가능합니다. --vault를 생략하면

프롬프트가 표시됩니다 (또는 나중에 ~/.obsidian-wiki/config에서 설정할 수 있습니다).

npx skills add Ar9av/obsidian-wiki를 실행하면

현재 에이전트 (Claude Code, Cursor, Codex 등)에 모든 위키 기술을 설치합니다. 그런 다음 에이전트를 열고 **"set up my wiki"**라고 말하세요.

전체 기술 목록은 skills.sh/ar9av/obsidian-wiki에서 찾아볼 수 있습니다.

git clone https://github.com/Ar9av/obsidian-wiki.git
cd obsidian-wiki
bash setup.sh

setup.sh

사용자의 볼트 (vault, 디지털 브레인으로 향하는 경로) 경로를 요청하고, 설정을 ~/.obsidian-wiki/config에 기록합니다.

또한, 모든 에이전트(agents)에 스킬(skills)을 심볼릭 링크(symlinks)로 연결하며, 어떤 프로젝트에서도 사용할 수 있도록 wiki-update를 전역(globally)으로 설치합니다.

에이전트에서 프로젝트를 열고 **"set up my wiki"**라고 말하세요. 그러면 끝입니다.

파일을 읽을 수 있는 **모든 AI 코딩 에이전트 (AI coding agent)**에서 작동합니다 — Claude Code, Cursor, Windsurf, Pi, Codex, Gemini CLI, Kiro 등이 포함됩니다. setup.sh는 각 에이전트에 대한 스킬 탐색(skill discovery)을 자동으로 처리합니다.

지원되는 에이전트 및 수동 설정 안내

에이전트 (Agent)	부트스트랩 (Bootstrap)	스킬 디렉토리 (Skills Directory)	슬래시 명령어 (Slash Commands)
Claude Code	`CLAUDE.md`	`.claude/skills/` + `~/.claude/skills/`	✅ `/wiki-ingest` , `/wiki-status` , 등
Cursor	`.cursor/rules/obsidian-wiki.mdc`	`.cursor/skills/`	✅ `/wiki-ingest` , `/wiki-status` , 등
Windsurf	`.windsurf/rules/obsidian-wiki.md`	`.windsurf/skills/`	✅ Cascade를 통해 사용
Codex (OpenAI)	`AGENTS.md`	`~/.codex/skills/`	`$wiki-ingest` (Codex는 `$`를 사용함)
Gemini CLI	`GEMINI.md`	`~/.gemini/skills/`	✅ `/wiki-ingest` , `/wiki-query` , 등
Google Antigravity	`.agent/rules/` + `.agent/workflows/`	`.agents/skills/`	✅ 워크플로 레지스트리 (workflows registry)를 통해 사용
Kiro IDE/CLI	`.kiro/steering/obsidian-wiki.md`	`.kiro/skills/` + `~/.kiro/skills/`	✅ `/wiki-ingest` , `/wiki-status` , 등
Hermes	`.hermes.md`	`~/.hermes/skills/`	✅ `/wiki-history-ingest hermes` , 등
OpenClaw	`AGENTS.md`	`~/.openclaw/skills/` + `~/.agents/skills/`	✅ `/wiki-ingest` , `/wiki-history-ingest openclaw` , 등
OpenCode	`AGENTS.md`	`~/.agents/skills/`	✅ `/wiki-ingest` , `/wiki-query` , 등
Aider	`AGENTS.md`	`~/.agents/skills/`	채팅에서 의도 설명
Factory Droid	`AGENTS.md`	`~/.agents/skills/`	✅ `/wiki-ingest` , `/wiki-query` , 등

각 에이전트(agent)는 스킬을 발견하는 고유한 규칙을 가지고 있습니다.

setup.sh

표준화된 .skills/ 디렉토리를 각 에이전트가 예상하는 위치로 심볼릭 링크(symlinks)합니다. 스킬은 한 번 작성하면 모든 에이전트가 사용할 수 있습니다.

Claude Code

스킬은 .claude/skills/에서 자동 발견됩니다.

setup.sh를 실행하거나
.skills/*를 .claude/skills/로 복사합니다.

리포지토리 루트에 있는 CLAUDE.md 파일은 프로젝트 컨텍스트(context)로 자동 로드됩니다.

`cd /path/to/obsidian-wiki && claude

. setup.sh

두 파일을 모두 전송하고 .agents/skills/로 기술 (skills)들을 심볼릭 링크 (symlinks) 합니다.

. 기존의 ~/.gemini/antigravity/skills/ 경로 또한 연결되어 있습니다.

Kiro IDE/CLI

inclusion: always 설정이 포함된 .kiro/steering/*.md를 통해 항상 활성화됩니다.

. setup.sh는 .skills/*를 .kiro/skills/와 ~/.kiro/skills/ 모두에 심볼릭 링크 (symlinks) 합니다.

. /wiki-ingest, /wiki-query 등으로 호출합니다.

OpenCode / Aider / Factory Droid / Trae

모두 리포지토리 (repo) 루트에 있는 AGENTS.md를 읽습니다. setup.sh는 기술 (skills)들을 ~/.agents/skills/ (공유 탐색 경로)로 심볼릭 링크 (symlinks) 합니다. Trae는 ~/.trae/skills/ 및 ~/.trae-cn/skills/도 지원합니다.

Hermes

.hermes.md를 먼저 읽고, 그다음 AGENTS.md로 대체 (fallback) 합니다. 기술 (skills)은 ~/.hermes/skills/에서 발견됩니다. setup.sh를 실행하거나 .skills/*를 해당 위치에 수동으로 심볼릭 링크 (symlink) 하세요.

cd /path/to/obsidian-wiki && hermes "set up my wiki"
# 나의 Hermes 기록을 위키 (wiki)로 마이닝 (mine):
/wiki-history-ingest hermes

OpenClaw

AGENTS.md를 읽습니다 (우선순위 10). 기술 (skills)은 ~/.openclaw/skills/ 및 ~/.agents/skills/에서 발견됩니다. 기술 (skills)은 슬래시 명령어 (slash commands)로 자동 등록됩니다.

cd /path/to/obsidian-wiki && openclaw "set up my wiki"
# OpenClaw 기록 마이닝:
/wiki-history-ingest openclaw

GitHub Copilot

VS Code Chat: .github/copilot-instructions.md를 읽습니다. Copilot Chat에서 "set up my wiki"라고 말하세요.

CLI: ~/.copilot/skills/에서 기술 (skills)을 발견합니다. setup.sh를 실행하거나 .skills/*를 해당 위치에 수동으로 심볼릭 링크 (symlink) 하세요.

Pi

AGENTS.md를 읽습니다 (현재 작업 디렉토리 (cwd)에서 상위로 탐색). 기술 (skills)은 .pi/skills/, .agents/skills/, 그리고 ~/.pi/agent/skills/에서 발견됩니다. setup.sh를 실행하거나 .skills/*를 ~/.pi/agent/skills/로 수동 심볼릭 링크 (symlink) 하세요.

cd /path/to/obsidian-wiki && pi "set up my wiki"
# Pi 세션 기록 마이닝:
/wiki-history-ingest pi

두뇌 (brain)에 데이터를 입력할 때마다, 다음 네 단계를 거쳐 실행됩니다:

1. Ingest (수집) — 에이전트가 소스 자료를 직접 읽습니다. 마크다운 (markdown) 파일, PDF (페이지 범위 지정 가능), JSONL 대화 내보내기, 일반 텍스트 로그, 채팅 내보내기, 회의 녹취록, 그리고 이미지 (스크린샷, 화이트보드 사진, 다이어그램 — 시각 지능 (vision) 기능이 있는 모델 필요) 등 당신이 제공하는 무엇이든 처리합니다. 전처리 단계나 실행해야 할 파이프라인이 없습니다. 에이전트는 코드를 읽는 것과 동일한 방식으로 파일을 읽습니다.

2. Pull Information (정보 추출) — 에이전트는 가공되지 않은 소스로부터 개념 (concepts), 엔티티 (entities), 주장 (claims), 관계 (relationships), 그리고 미해결 질문 (open questions)을 추출합니다. React 훅 (hook) 디버깅에 관한 대화에서는

리본 아이콘 (Ribbon Icon): 왼쪽 리본에서 "그래프 뷰 열기 (Open graph view)" 아이콘(연결된 네트워크 모양)을 클릭합니다. 명령 팔레트 (Command Palette): Ctrl + P (Windows/Linux) 또는 Cmd + P (Mac)를 누르고, "Open graph view"를 입력한 뒤 Enter를 누릅니다.

"color my graph", "color code by tag", "color by category", 또는 **"highlight visibility in graph"**라고 말하면 graph-colorize 스킬이 <vault>/.obsidian/graph.json 파일을 다시 작성하여, Obsidian이 태그, 폴더 또는 가시성(visibility)에 따라 노드에 색상을 입히도록 합니다. 이 스킬은 실제 어휘를 스캔하고, 색맹 친화적인 팔레트를 선택하며, 기존의 graph.json을 먼저 백업한 뒤 colorGroups 필드만 수정합니다. 따라서 사용자의 줌(zoom), 물리(physics), 필터(filter) 설정은 그대로 유지됩니다. 변경 사항을 확인하려면 Obsidian을 재로드(Cmd/Ctrl+R)하세요.

모드: by-tag (기본값 — 상위 10개 태그), by-category (7개의 볼트 폴더), by-visibility (visibility/pii 및 visibility/internal 강조), combined (가시성 + 태그), 또는 custom (사용자 제공 매핑).

델타 트래킹 (Delta tracking). 매니페스트(manifest)가 수집된 모든 소스 파일을 추적합니다: 경로, 타임스탬프, 생성된 위키 페이지 정보가 포함됩니다. 나중에 다시 돌아왔을 때, 델타(delta)를 계산하여 새로 추가되거나 변경된 내용만 처리합니다. 매번 문서 라이브러리 전체를 다시 수집할 필요가 없습니다. -
프로젝트 기반 조직화 (Project-based organization). 지식은 프로젝트별인 경우 프로젝트 아래에, 그렇지 않은 경우 전역(globally)으로 분류됩니다. 두 방식 모두 위키링크(wikilinks)로 상호 참조됩니다. 10개의 서로 다른 코드베이스에서 작업하는 경우, 각 코드베이스는 볼트 내에 자신만의 공간을 갖게 됩니다. -
아카이브 및 재구축 (Archive and rebuild). 위키가 소스에서 너무 멀어지면, 전체를 아카이브(타임스탬프가 찍힌 스냅샷, 데이터 손실 없음)하고 처음부터 다시 구축할 수 있습니다. 또는 이전의 어떤 아카이브로도 복구할 수 있습니다. -
멀티 에이전트 수집 (Multi-agent ingest). 문서, PDF, Claude Code 히스토리 (~/.claude), Codex 세션 (~/.codex/), Hermes 메모리 및 세션 (~/.hermes/), OpenClaw MEMORY.md 및 세션 (~/.openclaw/), Pi 세션 (~/.pi/agent/sessions/), Windsurf 데이터 (~/.windsurf