{"schemaVersion":"opencli.cli.v1","slug":"ytmd","name":"ytmd","shortName":"ytmd","binaryName":"ytmd","maker":{"slug":"gvkhosla","name":"Geet Khosla","type":"individual","url":"https://github.com/gvkhosla","officialPlatformMaker":false,"featuredBuilder":false},"category":"Docs / Content","description":"Read YouTube captions as evidence, chapter and timestamped retrieval, and feed videos to coding agents from the terminal. Built by Geet Khosla. Start with `ytmd doctor` and go from there. Supports structured output — good for scripts and agents. Runs entirely on your machine.","tagline":"Read YouTube captions as evidence, chapter and timestamped retrieval, and feed videos to coding agents from the terminal.","install":{"packageManager":"curl","command":"curl -fsSL https://raw.githubusercontent.com/gvkhosla/ytmd/main/install.sh | sh","packageName":null,"npmPackage":null,"brewFormula":null,"brewCask":null,"crateName":null,"pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"ytmd --version","signal":"ytmd responds locally and is ready for the first real command."},"quickStart":"ytmd add URL && ytmd read ID --max-chars 4000 --json","exampleWorkflow":["ytmd doctor","ytmd get https://youtu.be/jNQXAC9IVRw","ytmd search cache invalidation --json"],"agent":{"readiness":{"label":"Great for agents","score":85,"reasons":["Structured output is available for parsing.","Supports non-interactive/scripted use.","Works well in CI or repeatable automation.","Can run locally with less credential exposure."],"guardrails":["Network access is required; avoid leaking secrets in logs."]},"packUrl":"https://opencli.co/cli/ytmd/agent.md","packMarkdown":"# OpenCLI Agent Pack: ytmd\n\nUse this when an AI agent needs to work with `ytmd`.\n\n## What this CLI is for\nRead YouTube captions as evidence, chapter and timestamped retrieval, and feed videos to coding agents from the terminal. Built by Geet Khosla. Start with `ytmd doctor` and go from there. Supports structured output — good for scripts and agents. Runs entirely on your machine.\n\nBest for: read youtube captions as evidence, chapter and timestamped retrieval, and feed videos to coding agents from the terminal.\n\n## Agent readiness\nGreat for agents (85/100)\n- Structured output is available for parsing.\n- Supports non-interactive/scripted use.\n- Works well in CI or repeatable automation.\n- Can run locally with less credential exposure.\n\n## Install\n```sh\ncurl -fsSL https://raw.githubusercontent.com/gvkhosla/ytmd/main/install.sh | sh\n```\n\n## Verify before real work\n```sh\nytmd --version\n```\nExpected signal: ytmd responds locally and is ready for the first real command.\n\n## Safe starting commands\n```sh\nytmd --version\n```\n\n```sh\nytmd add URL && ytmd read ID --max-chars 4000 --json\n```\n\n```sh\nytmd doctor\n```\n\n```sh\nytmd get https://youtu.be/jNQXAC9IVRw\n```\n\n```sh\nytmd search cache invalidation --json\n```\n\n## Guardrails for agents\n- Network access is required; avoid leaking secrets in logs.\n\n## Suggested agent instruction\nYou may use ytmd (`ytmd`) for read youtube captions as evidence, chapter and timestamped retrieval, and feed videos to coding agents from the terminal.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.\n\nSource: OpenCLI\n"},"fit":{"bestFor":"read youtube captions as evidence, chapter and timestamped retrieval, and feed videos to coding agents from the terminal.","useThisIf":"You want docs and content that runs entirely on your machine.","skipIf":"You don't work with docs and content.","whatHappensNext":"Run `ytmd get https://youtu.be/jNQXAC9IVRw` to see it in action."},"capabilities":{"agentFriendly":true,"supportsJsonOutput":true,"supportsNonInteractive":true,"supportsDryRun":false,"requiresAuth":false,"requiresNetwork":true,"ciFriendly":true,"localFirst":true,"destructivePotential":"low"},"taxonomy":{"useCases":["Read YouTube captions as evidence","Chapter and timestamped retrieval","Feed videos to coding agents"],"aliases":["youtube markdown","youtube transcripts"],"keywords":["youtube","transcript","captions","agent"],"tags":["agent-friendly","local-first","json-output"]},"links":{"website":"https://gvkhosla.github.io/ytmd/","github":"https://github.com/gvkhosla/ytmd","docs":"https://gvkhosla.github.io/ytmd/llms.txt","opencli":"https://opencli.co/cli/ytmd","markdown":"https://opencli.co/cli/ytmd/agent.md","json":"https://opencli.co/cli/ytmd.json"},"metrics":{"githubStars":0,"latestRelease":"2026-09-14T08:44:28Z","license":"MIT","metricLabel":"GitHub release downloads (latest)","metricValue":6,"metricSource":"github","metricAsOf":"2026-09-14T15:56:24.097Z"}}