oh-my-til 0.13.0 → 1.0.0

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`만으로 바로 시작할 수 있습니다.
 
@@ -55,13 +71,17 @@ git clone 없이 `npx`만으로 바로 시작할 수 있습니다.
 3. **(선택) MCP 서버 시작** — Claude Code가 TIL 파일을 조회할 수 있게 합니다:
 
    ```bash
+   # HTTP 모드 — 상주 서버 실행
    npx oh-my-til serve ~/my-til
    claude mcp add --transport http oh-my-til http://localhost:22360/mcp
+
+   # stdio 모드 — 필요 시 자동 실행 (서버 불필요, Claude Desktop 호환)
+   claude mcp add oh-my-til -- npx oh-my-til mcp ~/my-til
    ```
 
 > **팁:** 경로 없이 `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`)
 
@@ -129,19 +149,15 @@ MCP 서버 연결 시 Claude Code에서 사용할 수 있는 도구:
 
 | 도구 | 설명 |
 |------|------|
-| `vault_read_note` | 경로로 노트 내용 읽기 |
-| `vault_list_files` | 폴더 내 파일 목록 (필터링 가능) |
-| `vault_search` | vault 전체 텍스트 검색 |
 | `vault_get_active_file` | 현재 열린 파일 가져오기 |
 | `til_list` | 카테고리별 TIL 파일 목록 (`search` 필터 지원) |
-| `til_exists` | category + slug로 TIL 파일 존재 여부 확인 |
-| `til_save_note` | frontmatter 형식/경로 규칙을 보장하는 TIL 노트 저장 |
+| `til_save_note` | TIL 노트 저장 (frontmatter/경로 규칙 보장, 백로그 자동 체크) |
 | `til_backlog_status` | 백로그 진행률 요약 (체크박스 카운트) |
-| `til_backlog_check` | 백로그 항목을 slug로 완료 처리 |
+| `til_backlog_check` | 백로그 항목을 slug로 완료 처리 (단독 사용 시) |
 | `til_get_context` | 주제 관련 기존 학습 컨텍스트 (파일, 링크 관계, 미작성 주제) |
 | `til_recent_context` | 최근 학습 활동을 날짜별로 조회 |
 | `til_dashboard` | 학습 통계 요약 |
-| `til_review_list` | 복습 대상 카드 목록 + 통계 (SRS) |
+| `til_review_list` | 복습 대상 카드 목록 + 통계 (SRS, `include_content` 지원) |
 | `til_review_update` | 복습 결과 기록 또는 복습 해제 |
 
 ## Claude 스킬
@@ -155,7 +171,6 @@ MCP 서버 연결 시 Claude Code에서 사용할 수 있는 도구:
 | **backlog** | `/backlog [카테고리]` | 학습 백로그 조회 및 진행 상황 요약 |
 | **save** | *(/til에서 자동 호출)* | TIL 마크다운 저장 + Daily 노트, MOC, 백로그 연동 |
 | **til-review** | `/til-review [카테고리]` | SRS 기반 간격 반복 복습 세션 (SM-2 알고리즘) |
-| **migrate-links** | `/migrate-links` | `[[wikilink]]`를 표준 마크다운 링크로 일괄 변환 |
 
 ## 개발
 

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`.
 
@@ -55,13 +71,17 @@ No git clone needed. Just `npx`.
 3. **(Optional) Start MCP server** — lets Claude Code query your TIL files:
 
    ```bash
+   # HTTP mode — runs a persistent server
    npx oh-my-til serve ~/my-til
    claude mcp add --transport http oh-my-til http://localhost:22360/mcp
+
+   # stdio mode — spawned on demand (no server needed, works with Claude Desktop)
+   claude mcp add oh-my-til -- npx oh-my-til mcp ~/my-til
    ```
 
 > **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`)
 
@@ -129,19 +149,15 @@ When the MCP server is connected, Claude Code can use these tools:
 
 | Tool | Description |
 |------|-------------|
-| `vault_read_note` | Read note content by path |
-| `vault_list_files` | List files in a folder with optional filtering |
-| `vault_search` | Full-text search across the vault |
 | `vault_get_active_file` | Get the currently open file |
 | `til_list` | List TIL files grouped by category (supports `search` filter) |
-| `til_exists` | Check if a TIL file exists by category + slug |
-| `til_save_note` | Save a TIL note with validated frontmatter and path conventions |
+| `til_save_note` | Save a TIL note with validated frontmatter and path conventions (auto backlog check) |
 | `til_backlog_status` | Backlog progress summary with checkbox counts |
-| `til_backlog_check` | Mark a backlog item as done by slug |
+| `til_backlog_check` | Mark a backlog item as done by slug (standalone use) |
 | `til_get_context` | Get existing knowledge context for a topic (files, links, unresolved mentions) |
 | `til_recent_context` | Recent learning activity grouped by date |
 | `til_dashboard` | Learning statistics summary |
-| `til_review_list` | Due review cards list + stats (SRS) |
+| `til_review_list` | Due review cards list + stats (SRS, supports `include_content`) |
 | `til_review_update` | Record review result or remove from review |
 
 ## Claude Skills
@@ -155,7 +171,6 @@ 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 |
 
 ## Development