Knowledge Manager Agent

📖 English documentation is available at the bottom of this page.

역할 경계: Knowledge Manager는 특정 내부 인프라(GraphRAG 검색 서버 등)에 의존하지 않고 단독 동작하는 범용 지식관리 제품입니다 — 그런 연동은 선택적 어댑터로만 제공됩니다.

Claude Code용 종합 지식 관리 에이전트. 다양한 소스에서 콘텐츠를 수집하고, Zettelkasten 원칙에 따라 분석하여, Obsidian 또는 Notion에 저장합니다.

✨ 특징

다중 소스 입력: 웹페이지, PDF, Notion
YouTube 트랜스크립트: YouTube 영상 자막 자동 추출 + 분석 + 노트 생성 ⭐ NEW
카카오톡 채팅 분석: 채팅방 메시지 분석 + 노트 생성 (macOS: 자동, Windows: 수동 내보내기) ⭐ NEW
PDF 및 이미지 OCR: 스캔된 PDF와 이미지에서 텍스트 추출 (Claude Code용)
스마트 추출: AI 기반 콘텐츠 분석 및 원자적 아이디어 추출
유연한 저장: Obsidian, Notion, 또는 로컬 Markdown 파일
PPT/슬라이드 생성: AI 이미지 기반 고퀄리티 프레젠테이션 (15+ 스타일)
간단한 설정: 셋업 위저드가 모든 것을 안내
카카오톡 전송: 정리된 노트를 카카오톡으로 자동 전송 (Windows/WSL)

📱 카카오톡 전송 설정

카카오톡 자동 전송은 kmsg에서 영감을 받아 제작되었습니다.

플랫폼	도구	설치
macOS	kmsg (원본)	`brew install channprj/tap/kmsg`
Windows/WSL	`send_kakao.py` (동봉)	추가 설치 불필요

Windows/WSL: KakaoTalk PC 버전이 실행 중이어야 합니다. send_kakao.py는 Win32 SendInput API로 메시지를 전송합니다.

macOS: kmsg는 macOS용 Swift 바이너리입니다. 자세한 사용법은 kmsg README를 참고하세요.

km-config.json 설정

{
  "kakao": {
    "enabled": true,
    "selfName": "홍길동"
  }
}

selfName: 본인 카카오톡 채팅방 이름 (실명). "나"가 아닌 본인 이름을 입력하세요!

🔍 vault 검색 — `/km:search`

수집·정리한 vault를 명령 하나로 검색합니다. 뒤에서 어떤 검색 엔진이 도는지는 자동으로 결정됩니다:

① GraphRAG 서버(설치돼 있으면) → ② Obsidian CLI → ③ Obsidian MCP → ④ 텍스트 검색

앞 단계가 없거나 실패하면 자동으로 다음 단계로 넘어가기 때문에, GraphRAG 없이도 바로 쓸 수 있고, 나중에 GraphRAG 스택을 얹으면 같은 명령이 자동으로 의미 기반 검색으로 올라섭니다 (스택 구축은 같은 플러그인의 /tofugraph 명령 — 상세: skills/km-graphrag-ops.md). 스택을 올린 뒤 검색이 실제로 잘 찾는지 스스로 재보고 싶다면 /tofugraph bench init 으로 시험지(질문 + 정답 노트)를 만들고 /tofugraph bench run 으로 채점합니다 — AI 채점이 아니라 정해진 규칙으로 매기므로 외부 API 키가 필요 없고, 같은 시험지로 다시 돌리면 같은 결과가 나옵니다.

/km:search MCP란?                      # 즉답 (quick)
/km:search --deep A와 B의 관계는?       # 상세 분석 (deep)

질문 형태에 따라 quick/deep 자동 선택, MOC(지도 노트) 우선 표시
답변은 항상 실제 노트 내용 기반 + 출처 경로 표기
Codex CLI 설치(방법 4)에서도 같은 검색이 km-search 스킬로 동작합니다.

🚀 설치 방법

방법 1: Claude Code 플러그인 (권장)

Claude Code 1.0.33 이상에서 플러그인으로 설치할 수 있습니다.

# 마켓플레이스 추가
/plugin marketplace add treylom/knowledge-manager

# 플러그인 설치
/plugin install km@knowledge-manager

설치 후 /km:setup으로 셋업 위저드를 실행하세요.

방법 2: 수동 복사 (Claude Code / Claude Desktop)

# 저장소 클론
git clone https://github.com/treylom/knowledge-manager.git
cd knowledge-manager

# .claude 폴더를 프로젝트에 복사
cp -r .claude /your/project/.claude
cp km-config.example.json /your/project/

복사 후 /knowledge-manager setup으로 셋업 위저드를 실행하세요.

방법 3: Antigravity 설정

Antigravity(Google)는 Agent Skills 표준을 지원합니다. .agent/skills/ 폴더를 사용하면 스킬이 자동으로 인식됩니다.

장점: Antigravity는 강력한 내장 브라우저 에이전트가 있어서 Playwright MCP가 필요 없습니다! Obsidian MCP만 설정하면 됩니다.

Step 1: 저장소 클론 및 스킬 복사

# 저장소 클론
git clone https://github.com/treylom/knowledge-manager.git

# .agent 폴더를 프로젝트에 복사 (Antigravity 스킬)
cp -r knowledge-manager/.agent /your/antigravity/project/

# .claude 폴더도 복사 (에이전트 및 명령어)
cp -r knowledge-manager/.claude /your/antigravity/project/

참고: .agent/skills/ 폴더는 Antigravity, Gemini CLI, Claude Code, OpenCode 등 Agent Skills 표준을 지원하는 모든 도구에서 호환됩니다.

Step 2: 자동 설정 (권장)

복사 후 Antigravity에서 다음과 같이 요청하세요:

Windows:

Knowledge Manager 설정을 도와줘.
내 Obsidian vault는 C:/Users/내이름/Documents/MyVault 야.

Mac:

Knowledge Manager 설정을 도와줘.
내 Obsidian vault는 /Users/내이름/Documents/MyVault 야.

Linux:

Knowledge Manager 설정을 도와줘.
내 Obsidian vault는 /home/내이름/Documents/MyVault 야.

에이전트가 자동으로:

MCP 설정 파일에 서버 추가
- Windows: %USERPROFILE%\.gemini\antigravity\mcp_config.json
- Mac/Linux: ~/.gemini/antigravity/mcp_config.json
km-config.json 생성
설정 완료 후 Refresh 방법 안내

Step 2 (대안): 수동 설정

자동 설정이 작동하지 않으면 수동으로 설정할 수 있습니다.

📋 수동 설정 방법 (클릭하여 펼치기)

MCP 서버 설정:

Antigravity에서 Agent 패널 열기
우측 상단 ⋯ (점 세 개) 클릭
MCP Servers 선택
Manage MCP Servers 클릭
View raw config 클릭

설정 파일 위치: C:\Users\<사용자명>\.gemini\antigravity\mcp_config.json

mcp_config.json에 다음 내용을 추가하세요:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@huangyihe/obsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "C:/Users/YourName/Documents/YourVault"
      }
    }
  }
}

참고: OBSIDIAN_VAULT_PATH를 실제 Obsidian vault 경로로 변경하세요.

Playwright는 선택 사항입니다. Antigravity 내장 브라우저가 웹 스크래핑을 처리합니다. 스크린샷 캡처, DOM 조작 등 고급 기능이 필요한 경우에만 Playwright를 추가하세요.

설정 새로고침:

Manage MCP Servers 창에서 Refresh 클릭
obsidian 서버가 목록에 표시되는지 확인

km-config.json 생성:

프로젝트 폴더에 km-config.json 파일을 생성하세요:

{
  "storage": {
    "primary": "obsidian",
    "obsidian": {
      "enabled": true,
      "vaultPath": "C:/Users/YourName/Documents/YourVault",
      "defaultFolder": "Zettelkasten"
    },
    "local": {
      "enabled": true,
      "outputPath": "./km-notes"
    }
  },
  "browser": {
    "provider": "antigravity"
  }
}

Step 3: 설정 확인

설정이 완료되면:

Manage MCP Servers 창에서 Refresh 클릭
obsidian 서버가 목록에 표시되는지 확인
테스트: "https://example.com 이 페이지를 정리해줘"

방법 4: Codex CLI 플러그인 (ChatGPT Codex)

# 저장소 클론 (또는 이미 받아둔 로컬 경로 사용)
git clone https://github.com/treylom/knowledge-manager.git

# 로컬 마켓플레이스 등록 + 플러그인 설치
codex plugin marketplace add ./knowledge-manager
codex plugin add km@knowledge-manager

설치되면 .agent/skills/의 스킬 세트(km-workflow · km-setup · km-search 등)가 Codex 스킬 카탈로그에 노출됩니다.
vault 검색도 동일하게 동작합니다 (Codex 스킬명은 km-search): 위 /km:search와 같은 4단계 자동 폴백을 수행합니다 — GraphRAG 서버가 없어도 Obsidian CLI·텍스트 검색이 받아줍니다. (③ Obsidian MCP 티어는 MCP를 연결한 경우에만 사용됩니다.)
Codex 환경은 이미 떠 있는 GraphRAG 서버(GRAPHRAG_API_URL 환경변수 또는 기본 http://127.0.0.1:8400)에 자동으로 연결합니다.
⚠️ Codex sandbox 주의: Codex 기본 sandbox 는 외부 바이너리 실행·네트워크를 제한합니다 — Obsidian CLI 검색 티어를 쓰려면 승인 응답 또는 ~/.codex/config.toml 의 sandbox_mode 상향이 필요합니다(막히면 텍스트 검색으로 자동 폴백은 됩니다). Obsidian 데스크톱 앱이 실행 중이어야 CLI 티어가 동작합니다.
지원 범위: Codex 플러그인은 현재 핵심 스킬 세트(km-workflow · km-setup · km-search · export · storage · social · zettelkasten 등 9종)를 제공합니다. PDF/YouTube/이미지 파이프라인·GraphRAG 구축·품질 재기(/tofugraph, bench 포함) 등 세부 스킬은 아직 Claude Code 전용입니다. km-setup 의 자동 환경분기도 Codex 미지원 — vault 경로는 첫 실행 때 직접 입력하면 됩니다.

💡 Obsidian Vault 경로 찾기

Vault 경로를 모르시면 아래 방법으로 확인하세요.

방법 1: Obsidian 앱에서 확인

Obsidian 앱 실행
좌측 하단 ⚙️ (설정) 클릭
"파일 및 링크" 메뉴 선택
상단에 표시된 "Vault 경로" 복사

방법 2: AI에게 요청

Claude Code 또는 Antigravity에게 직접 물어보세요:

내 Obsidian vault 경로 찾는 법 알려줘

OS별 일반적인 경로 예시

OS	경로 예시
Windows	`C:/Users/YourName/Documents/MyVault`
Mac	`/Users/YourName/Documents/MyVault`
Linux	`/home/yourname/Documents/MyVault`

⚠️ Windows 사용자: 역슬래시(\) 대신 슬래시(/)를 사용하세요!

❌ C:\Users\...

✅ C:/Users/...

📋 요구사항

필수

항목	설명
Claude Code / Antigravity	CLI, Desktop, 또는 Antigravity
Node.js 18+	MCP 서버 실행용

Playwright MCP 설치 (Claude Code 필수)

Antigravity 사용자: 내장 브라우저가 있어 Playwright MCP 불필요. 이 섹션 건너뛰기.

Claude Code 환경에서 웹 콘텐츠를 추출하려면 Playwright MCP 서버가 필요합니다.

# Playwright MCP 자동 설치 (권장)
claude mcp add playwright -- npx -y @anthropic-ai/mcp-playwright

# 설치 확인
claude mcp list
# → playwright 서버가 표시되어야 함

웹 크롤링 도구 우선순위:

콘텐츠 유형	1순위 도구	2순위 (Fallback)
SNS (Threads, Instagram)	Playwright MCP (필수)	-
일반 웹	WebFetch	Playwright MCP

YouTube 트랜스크립트 (선택)

항목	설치 명령	용도
youtube-transcript-api	`pip install youtube-transcript-api`	YouTube 자막 추출 (필수)
yt-dlp	`pip install yt-dlp`	자막 폴백 + 메타데이터 (권장)

카카오톡 채팅 분석 (선택)

카카오톡은 메시지 읽기 API를 제공하지 않아, macOS만 자동 수집이 가능합니다.

플랫폼	도구	자동화	설치
macOS	kmsg	자동 (Accessibility API)	`brew install channprj/tap/kmsg`
Windows/WSL	수동 "대화 내보내기" → TXT 파싱	수동 필요	추가 설치 불필요
(TXT 파서)	kakaotalk_msg_preprocessor	-	`pip install kakaotalk_msg_preprocessor`

선택 (셋업 위저드가 안내)

항목	용도
Obsidian	로컬 지식 관리 앱 (무료)
Notion 계정	팀 협업용

PDF/OCR 처리용 (Claude Code 환경)

Antigravity 사용자: 자체 내장 PDF/이미지 처리 기능 사용. 아래 설치 불필요.

항목	설치 명령	용도
Marker	`pip install marker-pdf`	PDF → Markdown 변환 (권장)
pytesseract	`pip install pytesseract pdf2image`	스캔 PDF OCR
Tesseract OCR	설치 가이드	OCR 엔진
pdfplumber	`pip install pdfplumber`	테이블 추출

📖 사용법

Claude Code에서

# 셋업 위저드 (최초 1회)
/knowledge-manager setup

# 웹 아티클 정리
/knowledge-manager https://example.com/article

# PDF 파일 처리
/knowledge-manager /path/to/document.pdf

# Threads 포스트 정리
/knowledge-manager https://threads.net/@user/post/123

# YouTube 영상 트랜스크립트 정리
/knowledge-manager https://youtube.com/watch?v=XXX

# 카카오톡 채팅방 분석 (대화 내보내기 TXT 파일)
/knowledge-manager 카톡방 "AI 오픈채팅" 이번 주 내용 정리해줘

플러그인으로 설치한 경우

# 셋업 위저드
/km:setup

# 웹 아티클 정리
/km https://example.com/article

🎨 PPT/슬라이드 생성 (NEW!)

AI 이미지 생성 기반의 고퀄리티 프레젠테이션을 만들 수 있습니다.

📦 Powered by baoyu-slide-deck - JimLiu의 baoyu-skills에서 제공하는 슬라이드 생성 스킬입니다.

사용법

# 콘텐츠에서 PPT 생성
/knowledge-manager https://example.com/article PPT로 만들어줘

# 스타일 지정
/knowledge-manager content.md sketch-notes 스타일로 슬라이드 생성

# 직접 슬라이드 생성
/baoyu-slide-deck content.md --style corporate

스타일 가이드

스타일	용도	추천 상황
`sketch-notes`	교육/튜토리얼	강의, 워크샵
`blueprint`	기술 문서	아키텍처, 시스템 설계
`corporate`	비즈니스	투자 발표, 경영 보고
`minimal`	미니멀	심플한 발표
`chalkboard`	강의실	교육 콘텐츠
`notion`	SaaS 대시보드	제품 데모, B2B

옵션

옵션	설명	예시
`--style <name>`	비주얼 스타일	`--style corporate`
`--audience <type>`	대상 청중	`--audience executives`
`--lang <code>`	출력 언어	`--lang ko`
`--slides <number>`	슬라이드 수	`--slides 15`
`--outline-only`	아웃라인만 생성	-

출력물

slide-deck/{topic}/
├── outline.md           # 아웃라인
├── 01-slide-cover.png   # 개별 슬라이드 이미지
├── ...
├── {topic}.pptx         # PowerPoint 파일
└── {topic}.pdf          # PDF 파일

📁 저장 방식

Obsidian 사용자

Obsidian vault에 Zettelkasten 스타일 노트로 저장됩니다.

Your-Vault/
├── Zettelkasten/
│   └── AI-연구/
│       └── MCP 프로토콜 개요 - 2026-01-17.md
├── Research/
└── Threads/

Obsidian 없이 사용

로컬 폴더에 Obsidian 호환 Markdown 파일로 저장됩니다.

km-notes/
├── Zettelkasten/
├── Research/
└── Threads/

🔧 문제 해결

Claude Code: MCP 서버 상태 확인

claude mcp list

Antigravity: MCP 서버 확인

Agent 패널 → ⋯ → MCP Servers
서버 목록에서 playwright, obsidian 상태 확인
연결 실패 시 Refresh 클릭

설정 파일 위치

환경	설정 파일
Claude Code CLI	프로젝트 폴더의 `.mcp.json`
Claude Desktop	`%APPDATA%\Claude\claude_desktop_config.json`
Antigravity	`C:\Users\<사용자명>\.gemini\antigravity\mcp_config.json`

고급 옵션

Hyperbrowser (선택적 대안)

⚠️ 권장하지 않음: 기본적으로 Playwright MCP를 사용하세요. Hyperbrowser는 Playwright가 차단당하는 특수한 경우에만 고려하세요.

Playwright MCP가 특정 사이트에서 지속적으로 차단당하는 경우에만 Hyperbrowser를 고려하세요.

hyperbrowser.ai에서 API 키 발급
km-config.json에서 browser.provider를 "hyperbrowser"로 변경
MCP 설정에 hyperbrowser 서버 추가:

"hyperbrowser": {
  "command": "npx",
  "args": ["-y", "hyperbrowser-mcp"],
  "env": {
    "HYPERBROWSER_API_KEY": "your-api-key"
  }
}

주의: Hyperbrowser는 유료 서비스이며, 설정이 복잡해질 수 있습니다. 대부분의 경우 Playwright MCP로 충분합니다.

환경 변수 지원

# (참고) 설정은 km-config.json 이 정본입니다 — 환경변수 오버라이드는 현재 미지원.

🤝 기여

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes
Push to the branch
Open a Pull Request

📄 라이선스

MIT License - 자유롭게 사용, 수정, 배포하세요.

🔗 관련 링크

🇺🇸 English Documentation

Role boundary: Knowledge Manager is a standalone, general-purpose knowledge tool — it does not depend on any private infrastructure (e.g., a GraphRAG search server); such integrations ship only as optional adapters.

Optional: if you run the GraphRAG stack (/tofugraph), you can self-score search quality with /tofugraph bench init → bench run — deterministic scoring, no external API key.

What is Knowledge Manager?

A comprehensive knowledge management agent for Claude Code. It collects content from various sources, analyzes it using Zettelkasten principles, and saves it to Obsidian or Notion.

Features

Multiple Input Sources: Web pages, PDFs, Notion
YouTube Transcripts: Auto-extract YouTube subtitles + analyze + generate notes
KakaoTalk Chat Analysis: Analyze chat messages + generate notes (macOS: auto, Windows: manual export)
PDF & Image OCR: Extract text from scanned PDFs and images (Claude Code)
Smart Extraction: AI-powered content analysis and atomic idea extraction
Flexible Storage: Obsidian, Notion, or local Markdown files
KakaoTalk Send: Auto-send notes to KakaoTalk (Windows/WSL)
Easy Setup: Setup wizard guides you through everything

Installation

Option 1: Claude Code Plugin (Recommended)

Available for Claude Code 1.0.33 and above.

# Add marketplace
/plugin marketplace add treylom/knowledge-manager

# Install plugin
/plugin install km@knowledge-manager

After installation, run /km:setup to start the setup wizard.

Option 2: Manual Copy (Claude Code / Claude Desktop)

# Clone repository
git clone https://github.com/treylom/knowledge-manager.git
cd knowledge-manager

# Copy .claude folder to your project
cp -r .claude /your/project/.claude
cp km-config.example.json /your/project/

After copying, run /knowledge-manager setup to start the setup wizard.

Option 3: Antigravity Setup

Antigravity (Google) supports the Agent Skills standard. The .agent/skills/ folder is automatically recognized.

Advantage: Antigravity has a powerful built-in browser agent, so Playwright MCP is not required! You only need to configure Obsidian MCP.

Step 1: Clone and Copy Skills

# Clone repository
git clone https://github.com/treylom/knowledge-manager.git

# Copy .agent folder (Antigravity skills)
cp -r knowledge-manager/.agent /your/antigravity/project/

# Also copy .claude folder (agents and commands)
cp -r knowledge-manager/.claude /your/antigravity/project/

Note: The .agent/skills/ folder is compatible with all tools supporting the Agent Skills standard, including Antigravity, Gemini CLI, Claude Code, and OpenCode.

Step 2: Automatic Setup (Recommended)

After copying, ask Antigravity:

Windows:

Help me set up Knowledge Manager.
My Obsidian vault is at C:/Users/MyName/Documents/MyVault.

Mac:

Help me set up Knowledge Manager.
My Obsidian vault is at /Users/MyName/Documents/MyVault.

Linux:

Help me set up Knowledge Manager.
My Obsidian vault is at /home/myname/Documents/MyVault.

The agent will automatically:

Add MCP servers to config file
- Windows: %USERPROFILE%\.gemini\antigravity\mcp_config.json
- Mac/Linux: ~/.gemini/antigravity/mcp_config.json
Create km-config.json
Guide you to refresh the configuration

Step 2 (Alternative): Manual Setup

If automatic setup doesn't work, you can configure manually.

📋 Manual Setup Instructions (click to expand)

Configure MCP Servers:

Open Agent panel in Antigravity
Click ⋯ (three dots) in the top right
Select MCP Servers
Click Manage MCP Servers
Click View raw config

Config file location: C:\Users\<username>\.gemini\antigravity\mcp_config.json

Add the following to mcp_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@huangyihe/obsidian-mcp"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "C:/Users/YourName/Documents/YourVault"
      }
    }
  }
}

Note: Replace OBSIDIAN_VAULT_PATH with your actual Obsidian vault path.

Playwright is optional. Antigravity's built-in browser handles web scraping. Only add Playwright if you need advanced features like screenshot capture or DOM manipulation.

Refresh Configuration:

Click Refresh in the Manage MCP Servers window
Verify that obsidian server appears in the list

Create km-config.json:

Create a km-config.json file in your project folder:

{
  "storage": {
    "primary": "obsidian",
    "obsidian": {
      "enabled": true,
      "vaultPath": "C:/Users/YourName/Documents/YourVault",
      "defaultFolder": "Zettelkasten"
    },
    "local": {
      "enabled": true,
      "outputPath": "./km-notes"
    }
  },
  "browser": {
    "provider": "antigravity"
  }
}

Step 3: Verify Setup

After setup is complete:

Click Refresh in the Manage MCP Servers window
Verify that obsidian server appears in the list
Test: "Summarize this page: https://example.com"

💡 Finding Your Obsidian Vault Path

If you don't know your vault path, here's how to find it.

Method 1: From Obsidian App

Open Obsidian app
Click ⚙️ (Settings) in the bottom left
Select "Files & Links"
Copy the "Vault path" shown at the top

Method 2: Ask AI

Ask Claude Code or Antigravity directly:

Help me find my Obsidian vault path

Typical Paths by OS

OS	Example Path
Windows	`C:/Users/YourName/Documents/MyVault`
Mac	`/Users/YourName/Documents/MyVault`
Linux	`/home/yourname/Documents/MyVault`

⚠️ Windows users: Use forward slashes (/) instead of backslashes (\)!

❌ C:\Users\...

✅ C:/Users/...

Requirements

Required

Item	Description
Claude Code / Antigravity	CLI, Desktop, or Antigravity
Node.js 18+	For running MCP servers

Playwright MCP Installation (Required for Claude Code)

Antigravity users: Has built-in browser, Playwright MCP not needed. Skip this section.

To extract web content in Claude Code, you need the Playwright MCP server.

# Auto-install Playwright MCP (recommended)
claude mcp add playwright -- npx -y @anthropic-ai/mcp-playwright

# Verify installation
claude mcp list
# → playwright server should appear

Web Crawling Tool Priority:

Content Type	Primary Tool	Fallback
SNS (Threads, Instagram)	Playwright MCP (required)	-
General Web	WebFetch	Playwright MCP

YouTube Transcripts (Optional)

Item	Install Command	Purpose
youtube-transcript-api	`pip install youtube-transcript-api`	YouTube subtitle extraction (required)
yt-dlp	`pip install yt-dlp`	Subtitle fallback + metadata (recommended)

KakaoTalk Chat Analysis (Optional)

KakaoTalk provides no message reading API. Only macOS supports auto-collection.

Platform	Tool	Automation	Install
macOS	kmsg	Auto (Accessibility API)	`brew install channprj/tap/kmsg`
Windows/WSL	Manual "Export Chat" → TXT parsing	Manual required	No additional install needed
(TXT parser)	kakaotalk_msg_preprocessor	-	`pip install kakaotalk_msg_preprocessor`

Optional (Setup wizard will guide you)

Item	Purpose
Obsidian	Local knowledge management app (free)
Notion account	For team collaboration

For PDF/OCR Processing (Claude Code)

Antigravity users: Use built-in PDF/image processing. No installation required.

Item	Install Command	Purpose
Marker	`pip install marker-pdf`	PDF → Markdown (recommended)
pytesseract	`pip install pytesseract pdf2image`	Scanned PDF OCR
Tesseract OCR	Install Guide	OCR engine
pdfplumber	`pip install pdfplumber`	Table extraction

Installation & Configuration

knowledge-manager is distributed as a git repository that adapts to your Obsidian vault at install time. The skill, agent, and command files in this repo contain placeholder tokens (e.g. {{VAULT_PATH}}) that get substituted with your real paths the first time you run the setup wizard. After that, git pull + /km-update keeps you current without ever touching your personal config.

First-time setup

# 1. Clone the repository
git clone https://github.com/treylom/knowledge-manager.git
cd knowledge-manager

# 2. (Optional) Install Node.js 18+ and Playwright MCP — see Requirements section above

# 3. Run the setup wizard inside Claude Code
#    Inside Claude Code, type:
/knowledge-manager-setup

The setup wizard will:

Ask for your Obsidian vault path (e.g. /home/you/Documents/MyVault or C:/Users/You/Documents/MyVault).
Auto-detect your Obsidian CLI executable (v1.12.4+) if Obsidian desktop is installed.
Generate km-config.json in the repo root (this file is gitignored — your personal config stays local).
Run scripts/configure-vault-paths.sh which replaces every {{VAULT_PATH}}, {{VAULT_NAME}}, {{OBSIDIAN_CLI}}, {{ZETTELKASTEN_ROOT}}, and {{RESEARCH_ROOT}} placeholder in skills/, agents/, commands/, and .claude/ with your real values.
Mark the substituted files with git update-index --skip-worktree so the replacements never show up as dirty in git status.

When the wizard finishes, every skill and command file points to your vault — no manual find-and-replace required.

Updating to the latest version

When you want to pull upstream improvements, use the /km-update slash command instead of a raw git pull:

/km-update

Under the hood this runs scripts/km-update.sh, which:

Unlocks the skip-worktree flag on every placeholder-substituted file.
Restores the original placeholder content with git checkout HEAD -- <files>.
Runs git pull origin <current-branch> to fetch upstream changes.
Re-runs scripts/configure-vault-paths.sh to re-substitute placeholders with your current km-config.json values.
Re-applies the skip-worktree lock.

A plain git pull will still work — but if your previous substitution has diverged from upstream (e.g. upstream changed a line around a placeholder), you may hit a merge conflict. /km-update is the safe path.

Re-configuring your vault path

If you move your vault, rename it, or want to point knowledge-manager at a different vault, just re-run the setup wizard:

/knowledge-manager-setup

The wizard backs up your existing km-config.json (timestamped), generates a new one, and re-runs the substitution engine. Your previous values are preserved in the backup file in case you need to roll back.

Under the hood — placeholder system

Source files in this repo use these 5 placeholder tokens. The setup wizard replaces them with values from your km-config.json:

Placeholder	Config field	Default	Meaning
`{{VAULT_PATH}}`	`storage.obsidian.vaultPath`	(required)	Absolute path to your Obsidian vault
`{{VAULT_NAME}}`	derived from basename of `vaultPath`	(derived)	Vault folder name (e.g. `MyVault`)
`{{OBSIDIAN_CLI}}`	`obsidianCli.path`	`""` (empty)	Path to Obsidian CLI executable; empty string if Obsidian desktop is not installed
`{{ZETTELKASTEN_ROOT}}`	`storage.obsidian.zettelkastenRoot`	`"Zettelkasten"`	Vault-relative path to your Zettelkasten root folder
`{{RESEARCH_ROOT}}`	`storage.obsidian.researchRoot`	`"Research"`	Vault-relative path to your research/MOC root folder

If you edit a skill file yourself and need it to stay portable, write the placeholder form (e.g. {{VAULT_PATH}}/Zettelkasten/note.md) and re-run /knowledge-manager-setup (or bash scripts/configure-vault-paths.sh directly). See docs/vault-path-configuration.md for the full technical reference, troubleshooting, and the skip-worktree rationale.

Usage

In Claude Code

# Setup wizard (first time only)
/knowledge-manager setup

# Process web article
/knowledge-manager https://example.com/article

# Process PDF file
/knowledge-manager /path/to/document.pdf

# Process Threads post
/knowledge-manager https://threads.net/@user/post/123

# YouTube video transcript
/knowledge-manager https://youtube.com/watch?v=XXX

# KakaoTalk chat analysis
/knowledge-manager Analyze "AI Chat Room" messages from this week

If installed as plugin

# Setup wizard
/km:setup

# Process web article
/km https://example.com/article

Storage

For Obsidian Users

Notes are saved in Zettelkasten style in your Obsidian vault.

Your-Vault/
├── Zettelkasten/
│   └── AI-Research/
│       └── MCP Protocol Overview - 2026-01-17.md
├── Research/
└── Threads/

Without Obsidian

Notes are saved as Obsidian-compatible Markdown files in a local folder.

km-notes/
├── Zettelkasten/
├── Research/
└── Threads/

Troubleshooting

Claude Code: Check MCP Server Status

claude mcp list

Antigravity: Check MCP Servers

Agent panel → ⋯ → MCP Servers
Check status of playwright and obsidian in server list
Click Refresh if connection failed

Config File Locations

Environment	Config File
Claude Code CLI	`.mcp.json` in project folder
Claude Desktop	`%APPDATA%\Claude\claude_desktop_config.json`
Antigravity	`C:\Users\<username>\.gemini\antigravity\mcp_config.json`

Advanced Options

Hyperbrowser (Optional Alternative)

⚠️ Not recommended: Use Playwright MCP by default. Only consider Hyperbrowser if Playwright is consistently blocked.

Only consider Hyperbrowser if Playwright MCP is consistently blocked on specific sites.

Get API key from hyperbrowser.ai
Change browser.provider to "hyperbrowser" in km-config.json
Add hyperbrowser server to MCP config:

"hyperbrowser": {
  "command": "npx",
  "args": ["-y", "hyperbrowser-mcp"],
  "env": {
    "HYPERBROWSER_API_KEY": "your-api-key"
  }
}

Note: Hyperbrowser is a paid service and may add configuration complexity. Playwright MCP is sufficient for most cases.

Environment Variable Support

# (Note) km-config.json is the source of truth — env-var overrides are not currently supported.

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes
Push to the branch
Open a Pull Request

License

MIT License - Free to use, modify, and distribute.

Name		Name	Last commit message	Last commit date
Latest commit History 117 Commits
.agent/skills		.agent/skills
.claude-plugin		.claude-plugin
.claude		.claude
.codex-plugin		.codex-plugin
.github		.github
agent-office/km-tools		agent-office/km-tools
agents		agents
commands		commands
docs		docs
scripts		scripts
skills		skills
.gitignore		.gitignore
.mcp.json.template		.mcp.json.template
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
km-config.example.json		km-config.example.json

Folders and files

Latest commit

History

Repository files navigation