km

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회):

1. 스마트폰에 ntfy 앱 설치: Android / iOS
2. 앱에서 고유한 토픽 구독 (예: my-km-alerts-xyz)
3. 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에서 다음과 같이 요청하세요: