yt-briefing 0.9.0 → 0.9.2

package/README.md

@@ -1,11 +1,11 @@
 # yt-briefing
 
 Save hours on YouTube. yt-briefing watches the channels you follow so you don't have to. For
-each new video it distills the essence in your own language — every point that matters, with
+each new video it gives you a short briefing in your own language — every point that matters, with
 only the filler cut, so nothing important is lost. Reading it takes a fraction of the time the
 video would, so you stay on top of everything and only watch what's actually worth it.
 
-It also gets better the more you use it. You give each briefing a quick rating, worth my time
+It also gets better the more you use it. You give each summary a quick rating, worth my time
 or not, and from that it learns what to keep showing you and what to drop. Over time the queue
 becomes yours: less noise, more of what you care about.
 
@@ -55,9 +55,9 @@ YT_BRIEFING_LLM_MODEL=gemini-2.5-flash
 YT_BRIEFING_YOUTUBE_API_KEY=<key>    # console.cloud.google.com → enable "YouTube Data API v3"
 ```
 
-Any OpenAI-compatible endpoint works — see [Providers](#providers) to use OpenRouter, OpenAI, or a
-local Ollama instead of Gemini. Miss a key and the engine tells you exactly which one. Keep `.env`
-gitignored; `YT_BRIEFING_PROXY` (datacenter/VPS IPs) is the only optional extra.
+Any OpenAI-compatible endpoint works — see [Providers](#providers) to use OpenRouter, OpenAI,
+Anthropic, or a local Ollama instead of Gemini. `YT_BRIEFING_PROXY` (datacenter/VPS IPs) is the
+only optional extra.
 
 4. Onboard:
 
@@ -77,30 +77,39 @@ npx yt-briefing list                                        # show the current l
 
 ## One-off: transcribe a single video
 
-Just want one video distilled — no channels, no queue, no rating? Run `/yt-transcribe` and
+Just want one video summarized — no channels, no queue, no rating? Run `/yt-transcribe` and
 paste a URL or video ID. It pulls that video's transcript and writes a journalist-grade
-briefing in the language you chose at setup (the same `output_lang` as `/yt`). Want a one-off in
+summary in the language you chose at setup (the same `output_lang` as `/yt`). Want a one-off in
 another language? Just say so when you run it (e.g. `/yt-transcribe <url> in German`) — it
 won't change your setup. `--lang pl|en` is separate — it picks which caption track to fetch,
-not the language it's written in.
+not the summary language.
 
-The skill is installed alongside `/yt` by `init` / `install-skill`. From the plain CLI:
+For example:
 
-```bash
-npx yt-briefing transcribe <url-or-id> --lang auto   # prints the transcript to stdout
+```
+/yt-transcribe https://www.youtube.com/watch?v=dQw4w9WgXcQ
 ```
 
 ## Search within a channel
 
 Mine one channel's videos for a topic and get a comparison. Run `/yt-search` with a channel and
-an intent — e.g. `/yt-search @betterstack which terminal for AI coding`.
+an intent — for example:
+
+```
+/yt-search @betterstack which terminal for AI coding
+```
 
 It covers the channel's **whole history** (not just recent uploads), re-ranks every upload against
 your intent, then lazily yields one matching video at a time to keep or skip — and synthesizes a
 comparison from everything you kept.
 
 The one flag is `--top N` — how many of the top re-ranked matches to triage (**default 10**). Raise
-it to go deeper, lower it for a quicker pass: `/yt-search @betterstack which terminal --top 20`.
+it to go deeper, lower it for a quicker pass:
+
+```
+/yt-search @betterstack which terminal
+/yt-search @betterstack which terminal --top 5
+```
 
 ## Run it
 
@@ -123,16 +132,17 @@ YT_BRIEFING_LLM_MODEL=gemini-2.5-flash
 > or switch to a paid key (enable billing, same model) to avoid it.
 
 Want something else? Change those three lines for OpenRouter (`https://openrouter.ai/api/v1`),
-OpenAI (`https://api.openai.com/v1`), or a local Ollama (`http://localhost:11434/v1`). Set
+OpenAI (`https://api.openai.com/v1`), Anthropic (`https://api.anthropic.com/v1/`,
+e.g. `claude-sonnet-4-6`), or a local Ollama (`http://localhost:11434/v1`). Set
 `YT_BRIEFING_LLM_BASE_URL`, `_API_KEY`, and `_MODEL` in your root `.env` (see [Setup](#setup)).
 
 ## Why an API, not the agent's native model
 
-The filtering and the briefings go through a plain OpenAI-compatible API call from the engine,
+The filtering and the summaries go through a plain OpenAI-compatible API call from the engine,
 not through the coding agent's own model. Two reasons.
 
 Speed. The engine works ahead in the background. It expands channels in parallel and starts
-on the next video's briefing while you rate the current one, so the following step is usually
+summarizing the next video while you rate the current one, so the following step is usually
 ready with no wait. An agent's turn-by-turn loop cannot prefetch like that, and every step pays
 its own cold start, which adds up across a whole queue.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yt-briefing",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "A self-learning YouTube briefing engine: it sweeps the channels you follow, filters noise in two stages (title, then transcript), summarizes the rest in your language, and adapts to your ratings — one video at a time.",
   "type": "module",
   "bin": {