Knowledge Manager Agent
📖 English documentation is available at the bottom of this page.
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+ 스타일)
- 간단한 설정: 셋업 위저드가 모든 것을 안내
- 모바일/Remote 지원: Claude Code Remote Control에서 키워드 기반 자동 프리셋으로 실행
- 카카오톡 전송: 정리된 노트를 카카오톡으로 자동 전송 (Windows/WSL)
- ntfy 완료 알림 (선택): 작업 완료 시 모바일 푸시 알림
📱 모바일/Remote 버전 (/knowledge-manager-m)
Claude Code Remote Control로 스마트폰에서 실행할 수 있는 경량 버전입니다.
일반 버전과의 차이
| /knowledge-manager | /knowledge-manager-m |
|---|
| 콘텐츠 설정 | AskUserQuestion 4문항 | 키워드 자동 프리셋 |
| 카카오톡 전송 | 없음 | 지원 (선택) |
| ntfy 완료 알림 | 없음 | 지원 (선택) |
| 환경 | 데스크톱 | 모바일/Remote/headless |
사용 예시
# 빠른 요약
/knowledge-manager-m https://example.com 요약해줘
# 상세 분석 + 카카오 전송
/knowledge-manager-m https://example.com 꼼꼼히 카카오 나에게
# 실무용 정리
/knowledge-manager-m https://example.com 실무용
키워드 프리셋
| 키워드 | 상세 | 중점 | 분할 | 연결 |
|---|
| "요약해줘" | 요약 | 전체 균형 | 단일 | 최대 |
| "꼼꼼히" | 상세 | 전체 균형 | 원자적 | 최대 |
| "기본" | 상세 | 전체 균형 | 3-tier | 최대 |
| (키워드 없음) | 상세 | 전체 균형 | 3-tier | 최대 |
카카오톡 전송 설정
카카오톡 자동 전송은 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: 본인 카카오톡 채팅방 이름 (실명). "나"가 아닌 본인 이름을 입력하세요!- 카카오톡 "나와의 채팅"은 본인 메시지에 대해 푸시 알림이 울리지 않습니다. 완료 알림이 필요하면 ntfy 설정을 권장합니다.
ntfy 완료 알림 설정 (선택)
ntfy는 선택 사항입니다. 카카오톡 전송만으로 충분하면 이 섹션을 건너뛰세요.
ntfy는 무료 오픈소스 푸시 알림 서비스입니다. 작업 완료 시 스마트폰에 알림을 보냅니다. 카카오톡 "나와의 채팅"은 본인 메시지에 대해 푸시 알림이 안 오기 때문에, 작업 완료 알림이 필요한 경우 권장합니다.
설정 방법 (1회):
- 스마트폰에 ntfy 앱 설치: Android / iOS
- 앱에서 고유한 토픽 구독 (예:
my-km-alerts-xyz)
km-config.json에 토픽 설정:
{
"notification": {
"ntfyTopic": "my-km-alerts-xyz"
}
}
Claude Code Remote Control 설정 권장사항 (선택)
모바일에서 Remote Control 사용 시 다음 설정을 권장합니다 (ntfy 사용자만 해당):
// ~/.claude/settings.json
{
"skipDangerousModePermissionPrompt": true,
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "curl -s -H 'Title: Claude 확인필요' -d '확인 필요' ntfy.sh/YOUR_TOPIC 2>/dev/null || true"
}
]
}
]
}
}
skipDangerousModePermissionPrompt: bypass 모드 시작 블로킹 제거Notification hook: permission 프롬프트나 idle 시 ntfy 알림- Plan mode 자동 승인은 현재 미지원 (GitHub #18523)
- 우회: bypass 모드 사용 또는
tmux send-keys로 원격 승인
🚀 설치 방법
방법 1: Claude Code 플러그인 (권장)
Claude Code 1.0.33 이상에서 플러그인으로 설치할 수 있습니다.
# 마켓플레이스 추가
/plugin marketplace add treylom/knowledge-manager
# 플러그인 설치
/plugin install 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 야.
