oh-my-til 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SongYunSeop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,209 @@
+# Oh My TIL
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Obsidian](https://img.shields.io/badge/Obsidian-v1.5.0+-7C3AED)](https://obsidian.md)
+[![Version](https://img.shields.io/github/v/release/SongYunSeop/oh-my-til)](https://github.com/SongYunSeop/oh-my-til/releases)
+
+[English](README.md) | **한국어**
+
+AI 기반 TIL(Today I Learned) 학습 워크플로우를 위한 Claude Code 플러그인입니다. 독립 CLI(`npx oh-my-til`)로 실행하거나, Obsidian 플러그인으로 사이드바에 Claude Code 터미널을 임베딩하여 사용할 수 있습니다.
+
+![Oh My TIL — 터미널 + TIL 노트](docs/screenshots/terminal-til.png)
+
+## 기능
+
+- **터미널 임베딩** — Obsidian 사이드바에서 Claude Code 터미널 실행 (xterm.js + node-pty)
+- **MCP 서버 내장** — Claude Code가 HTTP로 vault에 직접 접근 (별도 플러그인 불필요)
+- **학습 대시보드** — TIL 통계, 카테고리별 학습 현황을 한눈에
+- **스킬 자동 설치** — `/til`, `/research`, `/backlog`, `/save`, `/migrate-links` 명령을 바로 사용 가능
+- **마크다운 링크 감지** — 터미널의 `[텍스트](경로)` 링크를 클릭하면 노트 열기 (CJK 문자 지원)
+- **백로그 → TIL 연동** — 빈 백로그 링크 클릭 시 TIL 학습 세션 시작 제안
+- **파일 자동 열기** — 새로 생성된 TIL 파일을 에디터에서 자동으로 열기
+
+## 핵심 흐름
+
+```
+커맨드 팔레트 → 터미널 열기 → Claude Code 자동 시작
+→ /til, /backlog, /research, /save, /dashboard, /migrate-links 스킬 실행
+→ Claude가 리서치 → 대화형 학습 → TIL 마크다운 저장
+→ 새 파일 감지 → 에디터에서 자동 열기
+```
+
+## Standalone 사용법 (Obsidian 없이)
+
+`npx`로 Obsidian 없이 MCP 서버를 설치하고 실행할 수 있습니다:
+
+```bash
+npx oh-my-til init                              # 스킬/규칙/CLAUDE.md 섹션 설치
+npx oh-my-til serve                             # MCP 서버 시작 (기본 포트 22360)
+npx oh-my-til serve --port 3000 --til-path my-til
+```
+
+이후 Claude Code에서 MCP 서버를 연결합니다:
+
+```bash
+claude mcp add --transport http oh-my-til http://localhost:22360/mcp
+```
+
+## 시작하기 (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`)
+
+### 설치
+
+#### 방법 A: Claude Code (권장)
+
+```bash
+git clone https://github.com/SongYunSeop/oh-my-til.git
+cd oh-my-til
+claude
+# 실행 후: /install-plugin /path/to/your/vault
+```
+
+Claude Code가 Electron 버전을 자동 감지하고 네이티브 모듈 재빌드를 처리합니다.
+
+#### 방법 B: 수동 설치
+
+```bash
+git clone https://github.com/SongYunSeop/oh-my-til.git
+cd oh-my-til
+npm install
+ELECTRON_VERSION=<Electron-버전> npm run deploy -- /path/to/your/vault
+```
+
+> Electron 버전 확인: Obsidian 개발자 도구(Ctrl+Shift+I)에서 `process.versions.electron` 실행
+
+Obsidian을 재시작한 뒤 설정 > Community plugins에서 **Oh My TIL**을 활성화합니다.
+
+### MCP 서버 연결 (선택)
+
+플러그인이 HTTP 기반 MCP 서버를 내장하고 있어 Claude Code가 vault에 직접 접근할 수 있습니다:
+
+```bash
+claude mcp add --transport http oh-my-til http://localhost:22360/mcp
+```
+
+## 설정
+
+| 설정 | 기본값 | 설명 |
+|------|--------|------|
+| Shell 경로 | 시스템 기본 셸 | 터미널에서 사용할 셸 |
+| Claude 자동 실행 | `true` | 터미널 열릴 때 `claude` 명령 자동 실행 |
+| 이전 세션 재개 | `false` | 이전 Claude 세션 이어서 시작 (`--continue`) |
+| 글꼴 크기 | `13` | 터미널 글꼴 크기 (px) |
+| 글꼴 | `Menlo` | 터미널 글꼴 (Menlo, SF Mono, Fira Code, JetBrains Mono 등) |
+| 행간 | `1.0` | 터미널 행간 (1.0 = 기본, 최대 2.0) |
+| 새 TIL 파일 자동 열기 | `true` | til/ 폴더에 새 파일 생성 시 자동 오픈 |
+| MCP 서버 활성화 | `true` | 내장 MCP 서버 실행 여부 |
+| MCP 포트 | `22360` | MCP 서버 포트 |
+
+## MCP 도구
+
+MCP 서버 연결 시 Claude Code에서 사용할 수 있는 도구:
+
+| 도구 | 설명 |
+|------|------|
+| `vault_read_note` | 경로로 노트 내용 읽기 |
+| `vault_list_files` | 폴더 내 파일 목록 (필터링 가능) |
+| `vault_search` | vault 전체 텍스트 검색 |
+| `vault_get_active_file` | 현재 열린 파일 가져오기 |
+| `til_list` | 카테고리별 TIL 파일 목록 |
+| `til_backlog_status` | 백로그 진행률 요약 (체크박스 카운트) |
+| `til_get_context` | 주제 관련 기존 학습 컨텍스트 (파일, 링크 관계, 미작성 주제) |
+| `til_recent_context` | 최근 학습 활동을 날짜별로 조회 |
+
+## Claude 스킬
+
+플러그인이 `.claude/skills/`에 자동 설치하는 스킬:
+
+| 스킬 | 명령 | 설명 |
+|------|------|------|
+| **til** | `/til <주제> [카테고리]` | 주제 리서치 → 대화형 학습 → TIL 저장 |
+| **research** | `/research <주제> [카테고리]` | 주제를 리서치하여 학습 백로그 생성 |
+| **backlog** | `/backlog [카테고리]` | 학습 백로그 조회 및 진행 상황 요약 |
+| **save** | *(/til에서 자동 호출)* | TIL 마크다운 저장 + Daily 노트, MOC, 백로그 연동 |
+| **migrate-links** | `/migrate-links` | `[[wikilink]]`를 표준 마크다운 링크로 일괄 변환 |
+
+## 개발
+
+```bash
+npm run dev              # 워치 모드 (esbuild)
+npm test                 # 테스트 실행 (vitest)
+npm run rebuild-pty      # Obsidian Electron용 node-pty 재빌드
+npm run deploy -- /path  # vault에 배포
+npm run deploy -- --refresh-skills /path  # 스킬/규칙 강제 재설치 포함
+```
+
+### 프로젝트 구조
+
+```
+src/
+├── core/                    # 플랫폼 독립 순수 로직
+│   ├── backlog.ts           # 백로그 파싱/포맷 순수 함수
+│   ├── context.ts           # 학습 컨텍스트 헬퍼 (순수 함수)
+│   ├── stats.ts             # TIL 통계 순수 함수
+│   ├── migrate-links.ts     # Wikilink [[]] → [](path) 변환
+│   ├── keyboard.ts          # Shift+Enter → \n (멀티라인 지원)
+│   ├── env.ts               # macOS PATH 보정 (Homebrew)
+│   ├── skills.ts            # 버전 비교/플레이스홀더 치환 순수 함수
+│   └── index.ts             # barrel export
+├── ports/                   # 어댑터 인터페이스
+│   ├── storage.ts           # FileStorage 인터페이스
+│   └── metadata.ts          # MetadataProvider 인터페이스
+├── adapters/                # 포트 구현체
+│   ├── fs-adapter.ts        # node:fs 기반 (standalone)
+│   └── obsidian-adapter.ts  # Obsidian App 기반
+├── mcp/                     # MCP 서버 (포트 의존, Obsidian 무관)
+│   ├── server.ts            # HTTP 서버 + Streamable HTTP 트랜스포트
+│   └── tools.ts             # MCP 도구 정의 (FileStorage + MetadataProvider 사용)
+├── cli/                     # 독립 CLI 진입점
+│   └── index.ts             # npx oh-my-til init / serve
+└── obsidian/                # Obsidian 플랫폼 어댑터
+    ├── main.ts              # 플러그인 진입점
+    ├── settings.ts          # 설정 탭 + 인터페이스
+    ├── watcher.ts           # 파일 감시 → 에디터에서 열기
+    ├── skills.ts            # 스킬/규칙 자동 설치
+    ├── terminal/
+    │   ├── TerminalView.ts  # 사이드바 터미널 (ItemView + xterm.js)
+    │   ├── MarkdownLinkProvider.ts  # 3개 ILinkProvider: 마크다운, 파일경로, OSC 8
+    │   └── pty.ts           # PTY 프로세스 관리 (node-pty)
+    └── dashboard/
+        └── DashboardView.ts # 학습 대시보드 (ItemView)
+```
+
+### 기술 스택
+
+| | |
+|---|---|
+| **런타임** | TypeScript, Obsidian Plugin API |
+| **터미널** | xterm.js, node-pty |
+| **MCP** | @modelcontextprotocol/sdk |
+| **빌드** | esbuild |
+| **테스트** | vitest |
+
+## 로드맵
+
+- [x] Claude Code 터미널 임베딩
+- [x] MCP 서버 내장
+- [x] 학습 대시보드 (기본 통계)
+- [x] 독립 CLI (`npx oh-my-til`) — Obsidian 없이 사용
+- [ ] 대시보드 백로그 진행률 바
+- [ ] TIL 폴더 경로 커스터마이즈
+- [ ] 리치 대시보드 — 최근 TIL 목록, 학습 스트릭, 주간 요약
+- [ ] 동적 코드 블록 (`til-moc`, `til-daily`) — Dataview 없이 TIL 목록 자동 렌더링
+- [ ] 멀티 터미널 탭 — 여러 Claude Code 세션 동시 실행
+- [ ] 노트 링크 통합 — 관련 노트에 백링크 자동 삽입
+
+## 감사의 글
+
+- [claude-code-terminal](https://github.com/dternyak/claude-code-terminal) — xterm.js + node-pty Obsidian 통합 패턴의 원본
+- [Obsidian Developer Docs](https://docs.obsidian.md/Home)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+
+## 라이선스
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,209 @@
+# Oh My TIL
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Obsidian](https://img.shields.io/badge/Obsidian-v1.5.0+-7C3AED)](https://obsidian.md)
+[![Version](https://img.shields.io/github/v/release/SongYunSeop/oh-my-til)](https://github.com/SongYunSeop/oh-my-til/releases)
+
+**English** | [한국어](README.ko.md)
+
+A Claude Code plugin for AI-powered TIL (Today I Learned) learning workflow. Works as a standalone CLI (`npx oh-my-til`) or as an Obsidian plugin with embedded Claude Code terminal.
+
+![Oh My TIL — Terminal + TIL note](docs/screenshots/terminal-til.png)
+
+## Features
+
+- **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`, `/migrate-links` commands ready out of the box
+- **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
+- **File Watcher** — Newly created TIL files open automatically in the editor
+
+## How It Works
+
+```
+Command Palette → Open Terminal → Claude Code starts
+→ Run /til, /backlog, /research, /save, /dashboard, /migrate-links skills
+→ Claude researches → interactive learning → saves TIL markdown
+→ New file detected → opens in editor
+```
+
+## Standalone Usage (without Obsidian)
+
+Install and run the MCP server without Obsidian using `npx`:
+
+```bash
+npx oh-my-til init                              # Install skills, rules, and CLAUDE.md section
+npx oh-my-til serve                             # Start MCP server (default port 22360)
+npx oh-my-til serve --port 3000 --til-path my-til
+```
+
+Then connect Claude Code to the MCP server:
+
+```bash
+claude mcp add --transport http oh-my-til http://localhost:22360/mcp
+```
+
+## Getting Started (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`)
+
+### Installation
+
+#### Option A: Claude Code (Recommended)
+
+```bash
+git clone https://github.com/SongYunSeop/oh-my-til.git
+cd oh-my-til
+claude
+# Then run: /install-plugin /path/to/your/vault
+```
+
+Claude Code automatically detects Electron version and handles native module rebuilding.
+
+#### Option B: Manual
+
+```bash
+git clone https://github.com/SongYunSeop/oh-my-til.git
+cd oh-my-til
+npm install
+ELECTRON_VERSION=<your-electron-version> npm run deploy -- /path/to/your/vault
+```
+
+> To find your Electron version, open Obsidian's Developer Tools (Ctrl+Shift+I) and run `process.versions.electron`.
+
+Restart Obsidian, then enable **Oh My TIL** in Settings > Community plugins.
+
+### MCP Server Setup (Optional)
+
+The plugin runs an HTTP-based MCP server so Claude Code can access your vault directly:
+
+```bash
+claude mcp add --transport http oh-my-til http://localhost:22360/mcp
+```
+
+## Configuration
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| Shell Path | System default | Shell to use in the terminal |
+| Auto Launch Claude | `true` | Run `claude` when terminal opens |
+| Resume Last Session | `false` | Resume previous Claude session (`--continue`) |
+| Font Size | `13` | Terminal font size (px) |
+| Font Family | `Menlo` | Terminal font (Menlo, SF Mono, Fira Code, JetBrains Mono, etc.) |
+| Line Height | `1.0` | Terminal line spacing (1.0 = default, up to 2.0) |
+| Auto Open New TIL | `true` | Open new TIL files in editor automatically |
+| MCP Server | `true` | Enable built-in MCP server |
+| MCP Port | `22360` | MCP server port |
+
+## MCP Tools
+
+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 |
+| `til_backlog_status` | Backlog progress summary with checkbox counts |
+| `til_get_context` | Get existing knowledge context for a topic (files, links, unresolved mentions) |
+| `til_recent_context` | Recent learning activity grouped by date |
+
+## Claude Skills
+
+The plugin auto-installs these skills to `.claude/skills/`:
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| **til** | `/til <topic> [category]` | Research a topic → interactive learning → save TIL |
+| **research** | `/research <topic> [category]` | Research a topic and create a learning backlog |
+| **backlog** | `/backlog [category]` | View learning backlog and progress |
+| **save** | *(auto-invoked by /til)* | Save TIL markdown with Daily note, MOC, and backlog updates |
+| **migrate-links** | `/migrate-links` | Batch-convert `[[wikilinks]]` to standard markdown links |
+
+## Development
+
+```bash
+npm run dev              # Watch mode (esbuild)
+npm test                 # Run tests (vitest)
+npm run rebuild-pty      # Rebuild node-pty for Obsidian's Electron
+npm run deploy -- /path  # Deploy to vault
+npm run deploy -- --refresh-skills /path  # Deploy with skill/rule refresh
+```
+
+### Project Structure
+
+```
+src/
+├── core/                    # Platform-independent pure logic
+│   ├── backlog.ts           # Backlog parsing/formatting (pure functions)
+│   ├── context.ts           # Learning context helpers (pure functions)
+│   ├── stats.ts             # TIL statistics (pure functions)
+│   ├── migrate-links.ts     # Wikilink [[]] → [](path) conversion
+│   ├── keyboard.ts          # Shift+Enter → \n (multiline support)
+│   ├── env.ts               # macOS PATH resolution (Homebrew)
+│   ├── skills.ts            # Version comparison / placeholder substitution
+│   └── index.ts             # Barrel export
+├── ports/                   # Adapter interfaces
+│   ├── storage.ts           # FileStorage interface
+│   └── metadata.ts          # MetadataProvider interface
+├── adapters/                # Port implementations
+│   ├── fs-adapter.ts        # node:fs based (standalone)
+│   └── obsidian-adapter.ts  # Obsidian App based
+├── mcp/                     # MCP server (port-dependent, Obsidian-free)
+│   ├── server.ts            # HTTP server + Streamable HTTP transport
+│   └── tools.ts             # MCP tool definitions (FileStorage + MetadataProvider)
+├── cli/                     # Standalone CLI entry point
+│   └── index.ts             # npx oh-my-til init / serve
+└── obsidian/                # Obsidian platform adapter
+    ├── main.ts              # Plugin entry point
+    ├── settings.ts          # Settings tab & interface
+    ├── watcher.ts           # File watcher → open in editor
+    ├── skills.ts            # Skill/rule auto-installer
+    ├── terminal/
+    │   ├── TerminalView.ts  # Sidebar terminal (ItemView + xterm.js)
+    │   ├── MarkdownLinkProvider.ts  # 3 ILinkProviders: Markdown, Filepath, OSC 8
+    │   └── pty.ts           # PTY process manager (node-pty)
+    └── dashboard/
+        └── DashboardView.ts # Learning dashboard (ItemView)
+```
+
+### Tech Stack
+
+| | |
+|---|---|
+| **Runtime** | TypeScript, Obsidian Plugin API |
+| **Terminal** | xterm.js, node-pty |
+| **MCP** | @modelcontextprotocol/sdk |
+| **Build** | esbuild |
+| **Test** | vitest |
+
+## Roadmap
+
+- [x] Embedded Claude Code terminal
+- [x] Built-in MCP server
+- [x] Learning dashboard (basic stats)
+- [x] Standalone CLI (`npx oh-my-til`) — use without Obsidian
+- [ ] Backlog progress bars in dashboard
+- [ ] Configurable TIL folder path
+- [ ] Rich dashboard — recent TILs, streaks, weekly summary
+- [ ] Dynamic code blocks (`til-moc`, `til-daily`) — auto-render TIL lists without Dataview
+- [ ] Multi-terminal tabs — run multiple Claude Code sessions
+- [ ] Note linking — auto-insert backlinks to related notes
+
+## Acknowledgments
+
+- [claude-code-terminal](https://github.com/dternyak/claude-code-terminal) — Original xterm.js + node-pty Obsidian integration pattern
+- [Obsidian Developer Docs](https://docs.obsidian.md/Home)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+
+## License
+
+[MIT](LICENSE)