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

Installation

Option A: Standalone CLI (without Obsidian)

No git clone needed. Just npx.

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

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:

   npx oh-my-til init ~/my-til
   npx oh-my-til init ~/my-til --no-obsidian  # Skip Obsidian plugin installation

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

   cd ~/my-til
   claude

3. (Optional) Start MCP server — lets Claude Code query your TIL files:

   npx oh-my-til serve ~/my-til
   claude mcp add --transport http oh-my-til http://localhost:22360/mcp

Tip: You can also run npx oh-my-til init without a path to initialize the current directory.

Option B: Obsidian Plugin

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

Using npx (Recommended)

Run init inside your Obsidian vault — the plugin is installed automatically:

npx oh-my-til init /path/to/your/vault

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

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

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

Using Claude Code

git clone https://github.com/SongYunSeop/oh-my-til.git
cd oh-my-til
claude
# Then run: /install-plugin /path/to/your/vault

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) | | 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 (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_backlog_status | Backlog progress summary with checkbox counts | | til_backlog_check | Mark a backlog item as done by slug | | 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_update | Record review result or remove from review |

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

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)
│   ├── srs.ts               # Spaced repetition (SM-2 algorithm, review cards/stats)
│   ├── 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
│   ├── cli.ts               # CLI argument parsing (pure functions)
│   ├── config.ts            # Config file parsing/loading (pure functions)
│   ├── markdown.ts          # Markdown → HTML conversion (no external deps)
│   ├── profile.ts           # Static site page generation (profile, TIL pages, category index)
│   └── 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)
│   ├── context.ts           # Learning context tools (topic matching, category extraction)
│   ├── server.ts            # HTTP server + Streamable HTTP transport
│   └── tools.ts             # MCP tool definitions (FileStorage + MetadataProvider)
├── plugin-install.ts        # Plugin asset auto-install/update (skills, agents, CLAUDE.md section)
├── cli/                     # Standalone CLI entry point
│   ├── index.ts             # npx oh-my-til init / serve / deploy
│   └── obsidian-install.ts  # Auto-install Obsidian plugin (Electron detection, node-pty rebuild)
└── 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
• [x] Spaced Repetition (SRS) — SM-2 based review scheduling
• [ ] 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 — Original xterm.js + node-pty Obsidian integration pattern
• Obsidian Developer Docs
• MCP TypeScript SDK

License

MIT