oh-my-til 0.14.0 → 1.0.1

package/README.ko.md

@@ -15,7 +15,7 @@ AI 기반 TIL(Today I Learned) 학습 워크플로우를 위한 Claude Code 플
 - **터미널 임베딩** — Obsidian 사이드바에서 Claude Code 터미널 실행 (xterm.js + node-pty)
 - **MCP 서버 내장** — Claude Code가 HTTP로 vault에 직접 접근 (별도 플러그인 불필요)
 - **학습 대시보드** — TIL 통계, 카테고리별 학습 현황을 한눈에
-- **스킬 자동 설치** — `/til`, `/research`, `/backlog`, `/save`, `/til-review`, `/dashboard`, `/migrate-links` 명령을 바로 사용 가능
+- **스킬 자동 설치** — `/til`, `/research`, `/backlog`, `/save`, `/til-review`, `/dashboard` 명령을 바로 사용 가능
 - **간격 반복 복습 (SRS)** — SM-2 알고리즘 기반 TIL 복습 스케줄링
 - **마크다운 링크 감지** — 터미널의 `[텍스트](경로)` 링크를 클릭하면 노트 열기 (CJK 문자 지원)
 - **백로그 → TIL 연동** — 빈 백로그 링크 클릭 시 TIL 학습 세션 시작 제안
@@ -25,14 +25,30 @@ AI 기반 TIL(Today I Learned) 학습 워크플로우를 위한 Claude Code 플
 
 ```
 커맨드 팔레트 → 터미널 열기 → Claude Code 자동 시작
-→ /til, /backlog, /research, /save, /til-review, /dashboard, /migrate-links 스킬 실행
+→ /til, /backlog, /research, /save, /til-review, /dashboard 스킬 실행
 → Claude가 리서치 → 대화형 학습 → TIL 마크다운 저장
 → 새 파일 감지 → 에디터에서 자동 열기
 ```
 
 ## 설치
 
-### 방법 A: 독립 CLI (Obsidian 없이)
+### 방법 A: Claude Code Plugin (권장)
+
+Claude Code 플러그인으로 직접 설치 — 스킬, MCP 서버, 훅이 자동 등록됩니다.
+
+**요구 사항:** [Node.js](https://nodejs.org) 18 이상 / [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v1.0.33 이상
+
+```bash
+# marketplace 등록 (project scope 권장 — 해당 TIL vault에서만 활성화)
+claude plugin marketplace add https://github.com/SongYunSeop/oh-my-til.git --scope project
+
+# 플러그인 설치
+claude plugin install oh-my-til@oh-my-til --scope project
+```
+
+스킬은 네임스페이스가 적용됩니다: `/oh-my-til:til`, `/oh-my-til:research`, `/oh-my-til:backlog` 등.
+
+### 방법 B: 독립 CLI (Obsidian 없이)
 
 git clone 없이 `npx`만으로 바로 시작할 수 있습니다.
 
@@ -65,7 +81,7 @@ git clone 없이 `npx`만으로 바로 시작할 수 있습니다.
 
 > **팁:** 경로 없이 `npx oh-my-til init`을 실행하면 현재 디렉토리에 설치됩니다.
 
-### 방법 B: Obsidian 플러그인
+### 방법 C: Obsidian 플러그인
 
 **요구 사항:** [Obsidian](https://obsidian.md) v1.5.0 이상 / [Node.js](https://nodejs.org) 18 이상 / [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (`claude`)
 
@@ -85,15 +101,6 @@ ELECTRON_VERSION=37.10.2 npx oh-my-til init /path/to/your/vault
 
 > Electron 버전 확인: Obsidian 개발자 도구(Ctrl+Shift+I)에서 `process.versions.electron` 실행
 
-#### Claude Code로 설치
-
-```bash
-git clone https://github.com/SongYunSeop/oh-my-til.git
-cd oh-my-til
-claude
-# 실행 후: /install-plugin /path/to/your/vault
-```
-
 #### 수동 설치 (소스에서)
 
 ```bash
@@ -155,7 +162,9 @@ MCP 서버 연결 시 Claude Code에서 사용할 수 있는 도구:
 | **backlog** | `/backlog [카테고리]` | 학습 백로그 조회 및 진행 상황 요약 |
 | **save** | *(/til에서 자동 호출)* | TIL 마크다운 저장 + Daily 노트, MOC, 백로그 연동 |
 | **til-review** | `/til-review [카테고리]` | SRS 기반 간격 반복 복습 세션 (SM-2 알고리즘) |
-| **migrate-links** | `/migrate-links` | `[[wikilink]]`를 표준 마크다운 링크로 일괄 변환 |
+| **dashboard** | `/dashboard` | 학습 대시보드 — 통계, 활동 히트맵, 카테고리, 백로그 진행률 |
+| **omt-setup** | `/omt-setup [서브커맨드]` | 통합 설정 — init, deploy, oh-my-til 관리 |
+| **setup-obsidian** | `/setup-obsidian` | 현재 vault에 Obsidian 데스크톱 플러그인 설치 |
 
 ## 개발
 
@@ -176,7 +185,7 @@ src/
 │   ├── context.ts           # 학습 컨텍스트 헬퍼 (순수 함수)
 │   ├── stats.ts             # TIL 통계 순수 함수
 │   ├── srs.ts               # SRS 간격 반복 (SM-2 알고리즘, 복습 카드/통계)
-│   ├── migrate-links.ts     # Wikilink [[]] → [](path) 변환
+│   ├── migrate-links.ts     # Wikilink [[]] → [](path) 변환 (내부 유틸리티)
 │   ├── keyboard.ts          # Shift+Enter → \n (멀티라인 지원)
 │   ├── env.ts               # macOS PATH 보정 (Homebrew)
 │   ├── skills.ts            # 버전 비교/플레이스홀더 치환 순수 함수
@@ -197,7 +206,7 @@ src/
 │   └── tools.ts             # MCP 도구 정의 (FileStorage + MetadataProvider 사용)
 ├── plugin-install.ts        # 플러그인 에셋 자동 설치/업데이트 (skills, agents, CLAUDE.md 섹션)
 ├── cli/                     # 독립 CLI 진입점
-│   ├── index.ts             # npx oh-my-til init / serve / deploy
+│   ├── index.ts             # npx oh-my-til init / serve / mcp / install-obsidian / deploy
 │   └── obsidian-install.ts  # Obsidian 플러그인 자동 설치 (Electron 감지, node-pty 재빌드)
 └── obsidian/                # Obsidian 플랫폼 어댑터
     ├── main.ts              # 플러그인 진입점

package/README.md

@@ -15,7 +15,7 @@ A Claude Code plugin for AI-powered TIL (Today I Learned) learning workflow. Wor
 - **Embedded Terminal** — Claude Code terminal in Obsidian sidebar (xterm.js + node-pty)
 - **Built-in MCP Server** — Claude Code can directly access your vault via HTTP
 - **Learning Dashboard** — TIL statistics and category breakdown at a glance
-- **Auto-installed Skills** — `/til`, `/research`, `/backlog`, `/save`, `/til-review`, `/dashboard`, `/migrate-links` commands ready out of the box
+- **Auto-installed Skills** — `/til`, `/research`, `/backlog`, `/save`, `/til-review`, `/dashboard` commands ready out of the box
 - **Spaced Repetition (SRS)** — SM-2 algorithm-based review scheduling for TIL notes
 - **Markdown Link Detection** — `[text](path)` links in terminal are clickable and open notes (CJK-aware)
 - **Backlog-to-TIL Trigger** — Click an empty backlog link to start a TIL session
@@ -25,14 +25,30 @@ A Claude Code plugin for AI-powered TIL (Today I Learned) learning workflow. Wor
 
 ```
 Command Palette → Open Terminal → Claude Code starts
-→ Run /til, /backlog, /research, /save, /til-review, /dashboard, /migrate-links skills
+→ Run /til, /backlog, /research, /save, /til-review, /dashboard skills
 → Claude researches → interactive learning → saves TIL markdown
 → New file detected → opens in editor
 ```
 
 ## Installation
 
-### Option A: Standalone CLI (without Obsidian)
+### Option A: Claude Code Plugin (Recommended)
+
+Install directly as a Claude Code plugin — skills, MCP server, and hooks are auto-registered.
+
+**Prerequisites:** [Node.js](https://nodejs.org) 18+ / [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v1.0.33+
+
+```bash
+# Add marketplace (project scope recommended — only active in this TIL vault)
+claude plugin marketplace add https://github.com/SongYunSeop/oh-my-til.git --scope project
+
+# Install plugin
+claude plugin install oh-my-til@oh-my-til --scope project
+```
+
+Skills are namespaced: `/oh-my-til:til`, `/oh-my-til:research`, `/oh-my-til:backlog`, etc.
+
+### Option B: Standalone CLI (without Obsidian)
 
 No git clone needed. Just `npx`.
 
@@ -65,7 +81,7 @@ No git clone needed. Just `npx`.
 
 > **Tip:** You can also run `npx oh-my-til init` without a path to initialize the current directory.
 
-### Option B: Obsidian Plugin
+### Option C: Obsidian Plugin
 
 **Prerequisites:** [Obsidian](https://obsidian.md) v1.5.0+ / [Node.js](https://nodejs.org) 18+ / [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (`claude`)
 
@@ -85,15 +101,6 @@ ELECTRON_VERSION=37.10.2 npx oh-my-til init /path/to/your/vault
 
 > To find your Electron version, open Obsidian's Developer Tools (Ctrl+Shift+I) and run `process.versions.electron`.
 
-#### Using Claude Code
-
-```bash
-git clone https://github.com/SongYunSeop/oh-my-til.git
-cd oh-my-til
-claude
-# Then run: /install-plugin /path/to/your/vault
-```
-
 #### Manual Installation (from source)
 
 ```bash
@@ -155,7 +162,9 @@ The plugin auto-installs these skills to `.claude/skills/`:
 | **backlog** | `/backlog [category]` | View learning backlog and progress |
 | **save** | *(auto-invoked by /til)* | Save TIL markdown with Daily note, MOC, and backlog updates |
 | **til-review** | `/til-review [category]` | SRS-based spaced repetition review session (SM-2 algorithm) |
-| **migrate-links** | `/migrate-links` | Batch-convert `[[wikilinks]]` to standard markdown links |
+| **dashboard** | `/dashboard` | Learning dashboard — stats, activity heatmap, categories, backlog progress |
+| **omt-setup** | `/omt-setup [subcommand]` | Unified setup — init, deploy, and manage oh-my-til |
+| **setup-obsidian** | `/setup-obsidian` | Install the Obsidian desktop plugin in the current vault |
 
 ## Development
 
@@ -176,7 +185,7 @@ src/
 │   ├── context.ts           # Learning context helpers (pure functions)
 │   ├── stats.ts             # TIL statistics (pure functions)
 │   ├── srs.ts               # Spaced repetition (SM-2 algorithm, review cards/stats)
-│   ├── migrate-links.ts     # Wikilink [[]] → [](path) conversion
+│   ├── migrate-links.ts     # Wikilink [[]] → [](path) conversion (internal utility)
 │   ├── keyboard.ts          # Shift+Enter → \n (multiline support)
 │   ├── env.ts               # macOS PATH resolution (Homebrew)
 │   ├── skills.ts            # Version comparison / placeholder substitution
@@ -197,7 +206,7 @@ src/
 │   └── tools.ts             # MCP tool definitions (FileStorage + MetadataProvider)
 ├── plugin-install.ts        # Plugin asset auto-install/update (skills, agents, CLAUDE.md section)
 ├── cli/                     # Standalone CLI entry point
-│   ├── index.ts             # npx oh-my-til init / serve / deploy
+│   ├── index.ts             # npx oh-my-til init / serve / mcp / install-obsidian / deploy
 │   └── obsidian-install.ts  # Auto-install Obsidian plugin (Electron detection, node-pty rebuild)
 └── obsidian/                # Obsidian platform adapter
     ├── main.ts              # Plugin entry point