# OpenCLI Agent Pack: ytmd

Use this when an AI agent needs to work with `ytmd`.

## What this CLI is for
Save YouTube captions, search timestamped transcripts, 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.

Best for: save youtube captions, search timestamped transcripts, and feed videos to coding agents from the terminal.

## Agent readiness
Great for agents (85/100)
- 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.

## Install
```sh
curl -fsSL https://raw.githubusercontent.com/gvkhosla/ytmd/main/install.sh | sh
```

## Verify before real work
```sh
ytmd --version
```
Expected signal: ytmd responds locally and is ready for the first real command.

## Safe starting commands
```sh
ytmd --version
```

```sh
ytmd get URL && ytmd search WORDS
```

```sh
ytmd doctor
```

```sh
ytmd get https://youtu.be/jNQXAC9IVRw
```

```sh
ytmd search cache invalidation --json
```

## Guardrails for agents
- Network access is required; avoid leaking secrets in logs.

## Suggested agent instruction
You may use ytmd (`ytmd`) for save youtube captions, search timestamped transcripts, 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.

Source: OpenCLI