oh-my-til

Oh My TIL

English | 한국어

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.

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, /til-review, /til-lint, /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
• 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, /til-review, /til-lint, /dashboard skills
→ Claude researches → interactive learning → saves TIL markdown
→ New file detected → opens in editor

Installation

Option A: Claude Code Plugin (Recommended)

Install directly as a Claude Code plugin — skills, MCP server, and hooks are auto-registered.

Prerequisites: Node.js 18+ / Claude Code v1.0.33+

# 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)

Prerequisites: Node.js 18+ / Claude Code CLI (claude)

1. Install the Claude Code plugin (Option A above) — skills and MCP server are auto-registered.

2. Start Claude Code and use /til, /research, /backlog skills right away:

   cd ~/my-til
   claude
   

3. (Optional) Register MCP server — lets Claude Code query your TIL files (stdio mode, works with Claude Desktop):

   claude mcp add oh-my-til -- npx oh-my-til mcp ~/my-til
   

Option C: Obsidian Plugin

Prerequisites: Obsidian v1.5.0+ / Node.js 18+ / Claude Code CLI (claude)

Using npx (Recommended)

Install the Obsidian plugin directly:

npx oh-my-til install-obsidian /path/to/your/vault

Electron version is auto-detected on macOS. To override:

ELECTRON_VERSION=37.10.2 npx oh-my-til install-obsidian /path/to/your/vault

To find your Electron version, open Obsidian's Developer Tools (Ctrl+Shift+I) and run process.versions.electron.

Manual Installation (from source)

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

After installation, restart Obsidian and enable Oh My TIL in Settings > Community plugins.

MCP Server Setup (Optional)

The plugin includes a built-in MCP server so Claude Code can access your vault directly:

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)
TIL Path	til	TIL folder path. Skills follow it automatically (resolved CLI-first: --til-path → TIL_PATH env → oh-my-til.json → Obsidian setting → default)
Auto Open New TIL	true	Open new TIL files in editor automatically
Open Dashboard on Startup	false	Open learning dashboard when Obsidian starts
Claude Args	(empty)	Additional arguments passed to claude command

MCP Tools

When the MCP server is connected, Claude Code can use these tools: