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 +9 -25
- package/README.md +9 -25
- package/dist/cli.js +624 -2100
- package/main.js +42 -0
- package/manifest.json +8 -8
- package/package.json +64 -64
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.
|
|
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 서버
|
|
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
|
|
76
|
+
Obsidian 플러그인을 직접 설치합니다:
|
|
91
77
|
|
|
92
78
|
```bash
|
|
93
|
-
npx oh-my-til
|
|
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
|
|
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
|
-
|
|
|
135
|
-
|
|
|
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
|
|
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. **
|
|
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)
|
|
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
|
-
|
|
76
|
+
Install the Obsidian plugin directly:
|
|
91
77
|
|
|
92
78
|
```bash
|
|
93
|
-
npx oh-my-til
|
|
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
|
|
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
|
-
|
|
|
135
|
-
|
|
|
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
|
|
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
|