video-promo

A beautiful, interactive CLI for generating AI-powered promotional content for YouTube videos using the GitHub Copilot SDK.

Features

• Title Options - Generate 5 compelling title variations
• Video Description - SEO-optimized description with hooks and timestamps
• Chapter Markers - Auto-detected from transcript with accurate timestamps
• Twitter/X Posts - Announcement, thread starter, and engagement tweets
• LinkedIn Post - Professional format with call-to-action
• Newsletter Blurb - Ready-to-paste summary with subject lines
• Tags - SEO-friendly tag suggestions
• Thumbnail Ideas - Creative concepts for thumbnails
• Full Package - All of the above in one command

Model Selection

• Dynamic models: Available models are fetched from the Copilot API at startup
• Change anytime: Use /model command to switch models
• Premium indicators: Models marked with lightning bolt consume premium requests

Prerequisites

1. GitHub Copilot - Active subscription (individual, business, or enterprise)
2. GitHub CLI - Install from cli.github.com

Authentication

The app checks authentication on startup. If not authenticated, it will prompt you to log in interactively via gh auth login.

Installation

npm install -g video-promo

Or install from source:

git clone https://github.com/burkeholland/video-promo.git
cd video-promo
npm install
npm run build
npm link

Usage

# Start interactive mode
video-promo

# Start with a specific video
video-promo https://youtu.be/VIDEO_ID

Chat-Style Interface

Video Promo uses a chat-style interface with slash commands:

Content Commands

| Command | Description | |---------|-------------| | /title | Generate 5 title options | | /desc | Generate video description | | /chapters | Generate chapter timestamps | | /tweets | Generate Twitter/X posts | | /linkedin | Generate LinkedIn post | | /news | Generate newsletter blurb | | /tags | Generate SEO tags | | /thumb | Generate thumbnail ideas | | /full | Generate complete package |

Utility Commands

| Command | Description | |---------|-------------| | /copy | Copy last content to clipboard | | /last | Show last generated content | | /model | Switch AI model | | /clear | Clear screen | | /help | Show available commands | | /quit | Exit the app |

Natural Language Refinement

After generating content, type naturally to refine it:

> /title              # Generate 5 titles
> more like 3         # Get variations of title #3
> make them shorter   # Refine all titles
> add more emotion    # Apply feedback
> /copy               # Copy the result

Available AI Models

Models are fetched dynamically from the GitHub Copilot API at startup. Common models include:

• GPT-4o - Fast, high-quality responses (typically default)
• Claude Sonnet - Anthropic's latest model
• o-series - Advanced reasoning models

Premium models (billing multiplier > 1) display a lightning bolt indicator.

Tech Stack

• @github/copilot-sdk - AI orchestration via GitHub Copilot
• @inquirer/prompts - Beautiful interactive prompts
• commander - CLI argument parsing
• youtubei.js - YouTube metadata extraction (no API key needed)
• chalk + ora - Terminal styling and spinners
• clipboardy - System clipboard access

License

MIT