Ingest

Processes one source into the Library (~/Obsidian/Library/). Read ~/Obsidian/Library/CLAUDE.md (the wiki schema), ~/Obsidian/CONTEXT.md, and ~/Obsidian/CONVENTIONS.md (formatting) first.

Source types

• Article — a URL or clipped text. WebFetch the URL.

• Video — fetch the transcript, no download:

  uvx yt-dlp --skip-download --write-auto-sub --sub-lang en '<url>'
  

  The raw VTT carries YouTube's rolling captions, so dedupe it before reading: strip the WEBVTT header, cue timings and inline <c> tags, then drop each line that is a prefix of, or identical to, the line before it. Nothing to install — uv is present. If extraction fails on a missing JS runtime, brew install deno.

• Book — file the PDF into Library/raw/; Read handles PDFs directly. Ingest once per chapter or sitting, not once per book. One entities/ page for the book; each pass writes into concepts/.

Drain the Inbox

/ingest with no source given: read the top item in ~/Obsidian/Inbox/. One item per invocation — the queue drains by being worked, not by being triaged. Three outcomes: