Pp Dreaming

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/education/dreaming/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Dreaming — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the dreaming-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install dreaming --cli-only

2. Verify: dreaming-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish.

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Dreaming's web app shows your hours but won't plan, search, or bulk-import for you, and the community's features are scattered across a dozen browser extensions and scripts. This CLI unifies them into one agent-native tool backed by a local SQLite mirror of your catalog, daily series, and external-hours log - so next picks your next video offline, external import clears a CSV backlog in one shot, and roadmap lays out the whole L1-L7 fluency ladder with personalized ETAs.

When to Use This CLI

Use the Dreaming CLI for any task about a learner's comprehensible-input progress on Dreaming Spanish or French: checking hours and pace toward a fluency level, picking the next right-level video, searching the catalog by topic/guide/dialect, logging or bulk-importing external listening time, and analyzing whether consumed difficulty is trending up. It is the right tool whenever the question involves the hours-based roadmap or the leveled video catalog.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Roadmap intelligence

• next — Get the next unwatched videos tuned to where you are on the fluency roadmap, sorted by fine-grained difficulty.

  Reach for this instead of scrolling the catalog when an agent needs the single right-level, not-yet-watched video to recommend.

  dreaming next --limit 5 --agent

• diet — See whether the difficulty of what you actually watch is trending up over a window - the real signal that you're ready to level up.

  Use this to answer 'is this learner actually progressing, or stuck rewatching easy content?'

  dreaming diet --window 90d --agent

• roadmap — The whole L1-L7 ladder with comprehensible-input advisories (speaking, reading, native milestones) and personalized calendar ETAs in one view.

  Reach for this when the question is 'where am I on the path to fluency and when do I hit the next milestone?'

  dreaming roadmap --agent

External-hours logging

• external import — Import a backlog of outside listening/watching hours from a CSV in one command instead of dozens of web-form clicks.

  Use this whenever a learner has weeks of un-logged podcast/Netflix time to reconcile in bulk.

  dreaming external import backlog.csv --preview

Local state that compounds

• transcript — Fetch a video's captions as clean, timestamp-free plain text (and cache the cue-level transcript).

  Pick this when an agent needs to read or summarize what a single video actually says rather than just its title and tags.

  dreaming transcript 5f3a1b2c4d5e6f7a8b9c0d1e --agent

• concordance — Search every cached transcript for a word, phrase, regex, or verb-tense pattern and get each hit in context with the video, level, guide, and timestamp.

  Reach for this to find real, level-appropriate examples of a word or grammar form in context - the core ritual of grammar-in-context study.

  dreaming concordance --tense subjunctive-imperfect --level intermediate --agent

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Command Reference

day-watched-time — Manage day watched time

• dreaming-pp-cli day-watched-time — List per-day on-platform watch time

external-time — Manage external time

• dreaming-pp-cli external-time add — Log an external input-time entry
• dreaming-pp-cli external-time delete — Delete an external input-time entry by id
• dreaming-pp-cli external-time list — List your external (outside-platform) input-time log entries

inspect-external-video — Manage inspect external video

• dreaming-pp-cli inspect-external-video — Resolve a YouTube URL for external-time logging

playlist — Manage playlist

• dreaming-pp-cli playlist — List your watched-video playlist

sign-in — Manage sign in

• dreaming-pp-cli sign-in — Exchange email/password for a bearer token

user — Manage user

• dreaming-pp-cli user — Get your account stats (hours, daily goal, subscription)

video — Manage video

• dreaming-pp-cli video — Get a single video's metadata, captions, and stream sources

videos — Manage videos

• dreaming-pp-cli videos — List the video catalog

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

dreaming-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Plan to a deadline

dreaming plan --target 600h --by 2026-12-31

Back-solves the daily minutes you need to reach 600 hours (L5, speaking recommended) by a date.

Find the next video, agent-friendly

dreaming next --limit 5 --agent

Returns the next unwatched, level-appropriate videos as structured JSON for an agent to recommend.

Narrow a large catalog payload

dreaming next --level beginner --dialect rioplatense --agent --select title,guide,difficulty

The picker returns verbose video records; --select trims each to just the fields an agent needs.

Break down watched hours by teacher

dreaming stats by-guide --agent

Aggregates your watched videos per guide from the local store as structured JSON.

Check readiness to level up

dreaming diet --window 90d --agent

Shows whether the difficulty of what you actually watched is climbing over the last 90 days.

Read a video's transcript

dreaming transcript 5f3a1b2c4d5e6f7a8b9c0d1e

Fetches the inline captions and prints clean, timestamp-free text an agent can read or summarize.

Resolve a downloadable stream

dreaming download 5f3a1b2c4d5e6f7a8b9c0d1e

Prints the signed HLS URL and a ready ffmpeg command; add --exec to download when ffmpeg is installed.