Package Exports

askvideo
askvideo/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (askvideo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AskVideo CLI

Chat with any YouTube video from your terminal using AI

Features

Fast: Chat with YouTube videos in seconds without leaving your terminal
AI-Powered: Leverage advanced AI to understand and answer questions about video content
Interactive Mode: Have flowing conversations with video content
Scriptable: One-shot question mode perfect for automation and piping
Developer-Friendly: Built for developers who live in the terminal

Installation

npm install -g askvideo
# or
yarn global add askvideo

Quick Start

Get your API key from askvideo.ai/settings
Login with your API key:
```
askvideo login
```

Start chatting with any YouTube video:

askvideo chat "https://youtube.com/watch?v=dQw4w9WgXcQ"

Commands

`askvideo login`

Authenticate with your AskVideo API key.

# Interactive login
askvideo login

# Direct login with key
askvideo login --key av-api-your-key-here

`askvideo chat <url>`

Start an interactive chat session with a YouTube video.

# Chat with a YouTube video
askvideo chat "https://youtube.com/watch?v=VIDEO_ID"

# Chat with an already indexed video by ID
askvideo chat --id abc123

`askvideo ask <question>`

Ask a single question and get an answer (great for scripts).

# Ask a question about a video
askvideo ask "What are the main topics covered?" --url "https://youtube.com/watch?v=VIDEO_ID"

# Use video ID instead of URL
askvideo ask "Summarize this video" --id abc123

# Use simple mode (non-streaming, better for piping)
askvideo ask "List the key points" --url "..." --simple

`askvideo videos`

List all your indexed videos.

askvideo videos
# or
askvideo list

Usage Examples

Interactive Chat Session

$ askvideo chat "https://youtube.com/watch?v=dQw4w9WgXcQ"

  💬 AskVideo Chat
  ────────────────────────────────────────────────────────
  
  📹 Video: Never Gonna Give You Up
     ID: dQw4w9WgXcQ
  
  ────────────────────────────────────────────────────────
  
  Type your questions below. Use "exit" or Ctrl+C to quit.

  You: What is this song about?
  
  🤖 This song is about unwavering commitment and devotion in a 
     relationship. The lyrics express a promise to never abandon 
     or hurt the person they love...

  You: Who wrote this song?
  
  🤖 "Never Gonna Give You Up" was written by the production trio 
     Stock Aitken Waterman - Mike Stock, Matt Aitken, and Pete 
     Waterman...

Scripting / Automation

# Get a quick summary
askvideo ask "Give me a 3-bullet summary" --url "..." --simple

# Pipe to other commands
askvideo ask "List all timestamps" --url "..." --simple | grep "00:"

# Use in shell scripts
VIDEO_SUMMARY=$(askvideo ask "Summarize" --url "..." --simple)
echo "Summary: $VIDEO_SUMMARY"

Configuration

Configuration is stored in ~/.config/configstore/askvideo-cli.json.

Environment Variables

ASKVIDEO_API_URL - Override the API URL (useful for development)

API Key

Your API key can be generated at askvideo.ai/settings.

API keys:

Start with av-api-
Are tied to your AskVideo account
Respect your plan's usage limits

Credits & Limits

Free Plan: 1 video credit + 10 message credits per month
Pro Plan: Unlimited videos and messages

Check your remaining credits:

askvideo login  # Shows your current credits

Troubleshooting

"Authentication required"

Run askvideo login to authenticate with your API key.

"No video credits remaining"

You've used all your video credits for the month. Upgrade to Pro or wait for the next month.

"Failed to fetch transcript"

Some YouTube videos don't have transcripts available. Try a different video.

Video taking too long to process?

Longer videos take more time to transcribe and index. The CLI will wait up to 10 minutes.

Development

# Clone the repo
git clone https://github.com/your-org/askvideo-cli

# Install dependencies
yarn install

# Build
yarn build

# Run locally
node dist/index.js

License

MIT License - see LICENSE for details.

askvideo