Skip to main content
watch-cli composes yt-dlp, ffmpeg and a Whisper-class transcription model into one command. Your agent gets timestamped frames and the full transcript, then builds the artifact you asked for: a diagram, a component, a notebook, a cheat sheet. The only paid step is transcription, which runs through your Kyma key.

​
Quick setup

1

Get your API key

Sign up at kymaapi.com/signup. New accounts start with free credit on the free tier, which covers whisper-v3-turbo.
2

Install watch-cli

Without Homebrew, run the release installer pinned to a version. It downloads the tagged tarball and checks its SHA256 against the checksum on the same GitHub Release:
3

Watch a video

The command prints the frame paths and the transcript in one block. Repeat watches are cache hits and cost nothing.

​
As a skill or MCP server

  • Skill for Claude Code, Cursor, Codex, Gemini CLI and others: npx skills add sonpiaz/watch-cli
  • OpenClaw: clawhub skill install watch-cli
  • MCP server: see the mcp-server/ folder in the repository

​
What leaves your machine

The video is downloaded from its platform; frames stay on disk. Only the audio track is sent to Kyma for transcription. Login-walled videos fail unless you opt in with WATCH_BROWSER=auto, which lets yt-dlp read cookies from a browser you are signed in to on the same machine and send them only to that platform. Nothing is read by default.

​
Cost and models

Transcription uses Kyma’s speech-to-text models, priced per minute of audio; see Models for current rates. Frames are extracted locally and cost nothing.