rideo

Turn instructional videos into illustrated lessons with Codex and pi.

Packages

Package details

extensionskill

Install rideo from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:rideo
Package
rideo
Version
0.3.1
Published
Oct 21, 2026
Downloads
810/mo · 30/wk
Author
xunz03
License
ISC
Types
extension, skill
Size
589.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "skills": [
    "./dist/pi-skills"
  ],
  "extensions": [
    "./dist/pi.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Rideo

Rideo helps agents turn instructional videos into detailed, illustrated Markdown lessons, preserving explanations, reasoning, and worked examples. Lessons default to the source speaker's first-person voice, with source attribution and separate AI additions.

It works with existing agent hosts through a Codex plugin and a pi extension, backed by a shared TypeScript core and CLI.

What it does

  • Acquires platform captions or reads local SRT/WebVTT subtitles.
  • Prepares timestamped frames, explores evidence questions, and exports portable illustrations.
  • Provides rideo for authoring, rideo-qa for passage-level explanations, and explicitly requested rideo-review for independent review.

Output includes Markdown and image assets, in the user's requested language, otherwise their prompt language, otherwise English. Project and skill instructions are in English. Real ASR, media downloading, and clip extraction are not implemented yet.

Get started

Install the public npm package in pi:

pi install npm:rideo

For the standalone CLI, use npm install -g rideo. See the host integration guide for Codex installation, updates, and release archives. Distributed packages contain built JavaScript; installation does not require a TypeScript build.

Once installed, ask your agent:

Use the rideo skill to turn /work/lesson.mp4 and /work/lesson.vtt into a detailed illustrated lesson at /work/lesson-notes/tutorial.md. Preserve the explanations and worked examples.

While reading, ask for a clarification in the same manuscript:

Use rideo-qa on /work/lesson-notes/tutorial.md: I do not understand why we divide by the sample count in the loss section. Explain it with a small example and update that passage in the same first-person teaching voice.

Runtime requirements: Node.js 24+, FFmpeg/ffprobe 6+ for video preparation and new frames, and yt-dlp for platform subtitles. Reading and exporting existing evidence bundles requires neither the original media nor those external tools. The agent must support viewing images.

Develop locally

pnpm install
pnpm build
node dist/cli.js --help

Use Node.js 24+ and pnpm 12.4.1. Run pnpm package:hosts to build distributable Codex and pi packages.

Before committing, run:

pnpm check
pnpm test
pnpm test:hosts
pnpm test:integration

The host and media integration tests require FFmpeg/ffprobe. They use local fixtures and fake subtitle services, so no provider credentials or network access are required. test:hosts also builds and checks both distribution packages.

Documentation