Knowledge Manager Agent

# Knowledge Manager Agent

> 📖 **[English documentation is available at the bottom of this page.](#-english-documentation)**

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

## ✨ 특징

- **다중 소스 입력**: 웹페이지, PDF, 소셜 미디어 (Threads/Instagram), 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](https://code.claude.com/docs/en/remote-control)로 스마트폰에서 실행할 수 있는 경량 버전입니다.

### 일반 버전과의 차이

| | `/knowledge-manager` | `/knowledge-manager-m` |
|---|---|---|
| 콘텐츠 설정 | AskUserQuestion 4문항 | **키워드 자동 프리셋** |
| 카카오톡 전송 | 없음 | 지원 (선택) |
| ntfy 완료 알림 | 없음 | 지원 (선택) |
| 환경 | 데스크톱 | 모바일/Remote/headless |

### 사용 예시

```bash
# 빠른 요약
/knowledge-manager-m https://example.com 요약해줘

# 상세 분석 + 카카오 전송
/knowledge-manager-m https://example.com 꼼꼼히 카카오 나에게

# 실무용 정리
/knowledge-manager-m https://example.com 실무용
```

### 키워드 프리셋

| 키워드 | 상세 | 중점 | 분할 | 연결 |
|---|---|---|---|---|
| "요약해줘" | 요약 | 전체 균형 | 단일 | 최대 |
| "꼼꼼히" | 상세 | 전체 균형 | 원자적 | 최대 |
| "기본" | 상세 | 전체 균형 | 3-tier | 최대 |
| (키워드 없음) | 상세 | 전체 균형 | 3-tier | 최대 |

### 카카오톡 전송 설정

카카오톡 자동 전송은 [kmsg](https://github.com/channprj/kmsg)에서 영감을 받아 제작되었습니다.

| 플랫폼 | 도구 | 설치 |
|--------|------|------|
| **macOS** | [kmsg](https://github.com/channprj/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](https://github.com/channprj/kmsg#readme)를 참고하세요.

#### km-config.json 설정

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

- `selfName`: 본인 카카오톡 채팅방 이름 (실명). **"나"가 아닌 본인 이름을 입력하세요!**
- 카카오톡 "나와의 채팅"은 본인 메시지에 대해 **푸시 알림이 울리지 않습니다.** 완료 알림이 필요하면 ntfy 설정을 권장합니다.

### ntfy 완료 알림 설정 (선택)

> ntfy는 선택 사항입니다. 카카오톡 전송만으로 충분하면 이 섹션을 건너뛰세요.

[ntfy](https://ntfy.sh/)는 무료 오픈소스 푸시 알림 서비스입니다. 작업 완료 시 스마트폰에 알림을 보냅니다. 카카오톡 "나와의 채팅"은 본인 메시지에 대해 푸시 알림이 안 오기 때문에, 작업 완료 알림이 필요한 경우 권장합니다.

**설정 방법 (1회):**

1. 스마트폰에 ntfy 앱 설치: [Android](https://play.google.com/store/apps/details?id=io.heckel.ntfy) / [iOS](https://apps.apple.com/us/app/ntfy/id1625396347)
2. 앱에서 고유한 토픽 구독 (예: `my-km-alerts-xyz`)
3. `km-config.json`에 토픽 설정:

```json
{
  "notification": {
    "ntfyTopic": "my-km-alerts-xyz"
  }
}
```

### Claude Code Remote Control 설정 권장사항 (선택)

모바일에서 Remote Control 사용 시 다음 설정을 권장합니다 (ntfy 사용자만 해당):

```json
// ~/.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](https://github.com/anthropics/claude-code/issues/18523))
  - 우회: bypass 모드 사용 또는 `tmux send-keys`로 원격 승인

---

## 🚀 설치 방법

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

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

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

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

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

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

```bash
# 저장소 클론
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: 저장소 클론 및 스킬 복사

```bash
# 저장소 클론
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 설정을 도와줘.
내 Obsi

... (truncated)