oh-my-til 1.1.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ko.md CHANGED
@@ -50,16 +50,9 @@ claude plugin install oh-my-til@oh-my-til --scope project
50
50
 
51
51
  ### 방법 B: 독립 CLI (Obsidian 없이)
52
52
 
53
- git clone 없이 `npx`만으로 바로 시작할 수 있습니다.
54
-
55
53
  **요구 사항:** [Node.js](https://nodejs.org) 18 이상 / [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (`claude`)
56
54
 
57
- 1. **초기화** 디렉토리를 생성(필요 )하고 스킬, 규칙, CLAUDE.md 설정을 설치합니다. Obsidian vault가 감지되면(`.obsidian/` 존재) 플러그인도 자동 설치됩니다:
58
-
59
- ```bash
60
- npx oh-my-til init ~/my-til
61
- npx oh-my-til init ~/my-til --no-obsidian # Obsidian 플러그인 설치 건너뛰기
62
- ```
55
+ 1. **Claude Code 플러그인 설치** (방법 A 참고) 스킬과 MCP 서버가 자동 등록됩니다.
63
56
 
64
57
  2. **Claude Code 시작** — `/til`, `/research`, `/backlog` 스킬을 바로 사용할 수 있습니다:
65
58
 
@@ -68,35 +61,28 @@ git clone 없이 `npx`만으로 바로 시작할 수 있습니다.
68
61
  claude
69
62
  ```
70
63
 
71
- 3. **(선택) MCP 서버 시작** — Claude Code가 TIL 파일을 조회할 수 있게 합니다:
64
+ 3. **(선택) MCP 서버 등록** — Claude Code가 TIL 파일을 조회할 수 있게 합니다 (stdio 모드, Claude Desktop 호환):
72
65
 
73
66
  ```bash
74
- # HTTP 모드 — 상주 서버 실행
75
- npx oh-my-til serve ~/my-til
76
- claude mcp add --transport http oh-my-til http://localhost:22360/mcp
77
-
78
- # stdio 모드 — 필요 시 자동 실행 (서버 불필요, Claude Desktop 호환)
79
67
  claude mcp add oh-my-til -- npx oh-my-til mcp ~/my-til
80
68
  ```
81
69
 
82
- > **팁:** 경로 없이 `npx oh-my-til init`을 실행하면 현재 디렉토리에 설치됩니다.
83
-
84
70
  ### 방법 C: Obsidian 플러그인
85
71
 
86
72
  **요구 사항:** [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`)
87
73
 
88
74
  #### npx로 설치 (권장)
89
75
 
90
- Obsidian vault 안에서 `init`을 실행하면 플러그인이 자동 설치됩니다:
76
+ Obsidian 플러그인을 직접 설치합니다:
91
77
 
92
78
  ```bash
93
- npx oh-my-til init /path/to/your/vault
79
+ npx oh-my-til install-obsidian /path/to/your/vault
94
80
  ```
95
81
 
96
82
  macOS에서는 Electron 버전이 자동 감지됩니다. 수동 지정:
97
83
 
98
84
  ```bash
99
- ELECTRON_VERSION=37.10.2 npx oh-my-til init /path/to/your/vault
85
+ ELECTRON_VERSION=37.10.2 npx oh-my-til install-obsidian /path/to/your/vault
100
86
  ```
101
87
 
102
88
  > Electron 버전 확인: Obsidian 개발자 도구(Ctrl+Shift+I)에서 `process.versions.electron` 실행
@@ -130,9 +116,10 @@ claude mcp add --transport http oh-my-til http://localhost:22360/mcp
130
116
  | 글꼴 크기 | `13` | 터미널 글꼴 크기 (px) |
131
117
  | 글꼴 | `Menlo` | 터미널 글꼴 (Menlo, SF Mono, Fira Code, JetBrains Mono 등) |
132
118
  | 행간 | `1.0` | 터미널 행간 (1.0 = 기본, 최대 2.0) |
119
+ | TIL 폴더 경로 | `til` | TIL 파일 저장 경로 |
133
120
  | 새 TIL 파일 자동 열기 | `true` | til/ 폴더에 새 파일 생성 시 자동 오픈 |
134
- | MCP 서버 활성화 | `true` | 내장 MCP 서버 실행 여부 |
135
- | MCP 포트 | `22360` | MCP 서버 포트 |
121
+ | 시작 대시보드 열기 | `false` | Obsidian 시작 학습 대시보드 자동 열기 |
122
+ | Claude 추가 인자 | *(비어 있음)* | `claude` 명령에 전달할 추가 인자 |
136
123
 
137
124
  ## MCP 도구
138
125
 
@@ -201,17 +188,14 @@ src/
201
188
  │ └── obsidian-adapter.ts # Obsidian App 기반
202
189
  ├── mcp/ # MCP 서버 (포트 의존, Obsidian 무관)
203
190
  │ ├── context.ts # 학습 컨텍스트 도구 (topic 매칭, 카테고리 추출)
204
- │ ├── server.ts # HTTP 서버 + Streamable HTTP 트랜스포트
205
191
  │ └── tools.ts # MCP 도구 정의 (FileStorage + MetadataProvider 사용)
206
- ├── plugin-install.ts # 플러그인 에셋 자동 설치/업데이트 (skills, agents, CLAUDE.md 섹션)
207
192
  ├── cli/ # 독립 CLI 진입점
208
- │ ├── index.ts # npx oh-my-til init / serve / mcp / install-obsidian / deploy
193
+ │ ├── index.ts # npx oh-my-til mcp / install-obsidian / deploy
209
194
  │ └── obsidian-install.ts # Obsidian 플러그인 자동 설치 (Electron 감지, node-pty 재빌드)
210
195
  └── obsidian/ # Obsidian 플랫폼 어댑터
211
196
  ├── main.ts # 플러그인 진입점
212
197
  ├── settings.ts # 설정 탭 + 인터페이스
213
198
  ├── watcher.ts # 파일 감시 → 에디터에서 열기
214
- ├── skills.ts # 스킬/규칙 자동 설치
215
199
  ├── terminal/
216
200
  │ ├── TerminalView.ts # 사이드바 터미널 (ItemView + xterm.js)
217
201
  │ ├── MarkdownLinkProvider.ts # 3개 ILinkProvider: 마크다운, 파일경로, OSC 8
package/README.md CHANGED
@@ -50,16 +50,9 @@ Skills are namespaced: `/oh-my-til:til`, `/oh-my-til:research`, `/oh-my-til:back
50
50
 
51
51
  ### Option B: Standalone CLI (without Obsidian)
52
52
 
53
- No git clone needed. Just `npx`.
54
-
55
53
  **Prerequisites:** [Node.js](https://nodejs.org) 18+ / [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (`claude`)
56
54
 
57
- 1. **Initialize** creates the directory (if needed) and installs skills, rules, and CLAUDE.md config. If an Obsidian vault is detected (`.obsidian/` exists), the plugin is auto-installed too:
58
-
59
- ```bash
60
- npx oh-my-til init ~/my-til
61
- npx oh-my-til init ~/my-til --no-obsidian # Skip Obsidian plugin installation
62
- ```
55
+ 1. **Install the Claude Code plugin** (Option A above) skills and MCP server are auto-registered.
63
56
 
64
57
  2. **Start Claude Code** and use `/til`, `/research`, `/backlog` skills right away:
65
58
 
@@ -68,35 +61,28 @@ No git clone needed. Just `npx`.
68
61
  claude
69
62
  ```
70
63
 
71
- 3. **(Optional) Start MCP server** — lets Claude Code query your TIL files:
64
+ 3. **(Optional) Register MCP server** — lets Claude Code query your TIL files (stdio mode, works with Claude Desktop):
72
65
 
73
66
  ```bash
74
- # HTTP mode — runs a persistent server
75
- npx oh-my-til serve ~/my-til
76
- claude mcp add --transport http oh-my-til http://localhost:22360/mcp
77
-
78
- # stdio mode — spawned on demand (no server needed, works with Claude Desktop)
79
67
  claude mcp add oh-my-til -- npx oh-my-til mcp ~/my-til
80
68
  ```
81
69
 
82
- > **Tip:** You can also run `npx oh-my-til init` without a path to initialize the current directory.
83
-
84
70
  ### Option C: Obsidian Plugin
85
71
 
86
72
  **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`)
87
73
 
88
74
  #### Using npx (Recommended)
89
75
 
90
- Run `init` inside your Obsidian vault — the plugin is installed automatically:
76
+ Install the Obsidian plugin directly:
91
77
 
92
78
  ```bash
93
- npx oh-my-til init /path/to/your/vault
79
+ npx oh-my-til install-obsidian /path/to/your/vault
94
80
  ```
95
81
 
96
82
  Electron version is auto-detected on macOS. To override:
97
83
 
98
84
  ```bash
99
- ELECTRON_VERSION=37.10.2 npx oh-my-til init /path/to/your/vault
85
+ ELECTRON_VERSION=37.10.2 npx oh-my-til install-obsidian /path/to/your/vault
100
86
  ```
101
87
 
102
88
  > To find your Electron version, open Obsidian's Developer Tools (Ctrl+Shift+I) and run `process.versions.electron`.
@@ -130,9 +116,10 @@ claude mcp add --transport http oh-my-til http://localhost:22360/mcp
130
116
  | Font Size | `13` | Terminal font size (px) |
131
117
  | Font Family | `Menlo` | Terminal font (Menlo, SF Mono, Fira Code, JetBrains Mono, etc.) |
132
118
  | Line Height | `1.0` | Terminal line spacing (1.0 = default, up to 2.0) |
119
+ | TIL Path | `til` | TIL folder path |
133
120
  | Auto Open New TIL | `true` | Open new TIL files in editor automatically |
134
- | MCP Server | `true` | Enable built-in MCP server |
135
- | MCP Port | `22360` | MCP server port |
121
+ | Open Dashboard on Startup | `false` | Open learning dashboard when Obsidian starts |
122
+ | Claude Args | *(empty)* | Additional arguments passed to `claude` command |
136
123
 
137
124
  ## MCP Tools
138
125
 
@@ -201,17 +188,14 @@ src/
201
188
  │ └── obsidian-adapter.ts # Obsidian App based
202
189
  ├── mcp/ # MCP server (port-dependent, Obsidian-free)
203
190
  │ ├── context.ts # Learning context tools (topic matching, category extraction)
204
- │ ├── server.ts # HTTP server + Streamable HTTP transport
205
191
  │ └── tools.ts # MCP tool definitions (FileStorage + MetadataProvider)
206
- ├── plugin-install.ts # Plugin asset auto-install/update (skills, agents, CLAUDE.md section)
207
192
  ├── cli/ # Standalone CLI entry point
208
- │ ├── index.ts # npx oh-my-til init / serve / mcp / install-obsidian / deploy
193
+ │ ├── index.ts # npx oh-my-til mcp / install-obsidian / deploy
209
194
  │ └── obsidian-install.ts # Auto-install Obsidian plugin (Electron detection, node-pty rebuild)
210
195
  └── obsidian/ # Obsidian platform adapter
211
196
  ├── main.ts # Plugin entry point
212
197
  ├── settings.ts # Settings tab & interface
213
198
  ├── watcher.ts # File watcher → open in editor
214
- ├── skills.ts # Skill/rule auto-installer
215
199
  ├── terminal/
216
200
  │ ├── TerminalView.ts # Sidebar terminal (ItemView + xterm.js)
217
201
  │ ├── MarkdownLinkProvider.ts # 3 ILinkProviders: Markdown, Filepath, OSC 8