Summarize

Fast CLI to summarize URLs, local files, and YouTube links.

Quick Start

summarize "https://example.com" --model google/gemini-3-flash-preview
summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto

YouTube: Summary vs Transcript

Best-effort transcript extraction (URLs only):

summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only

If the user asked for a transcript but it's very long, return a tight summary first, then ask which section or time range to expand.

Model + Keys

Set the API key for your chosen provider:

• OpenAI: OPENAIAPIKEY
• Anthropic: ANTHROPICAPIKEY
• xAI: XAIAPIKEY
• Google: GEMINIAPIKEY (aliases: GOOGLEGENERATIVEAIAPIKEY, GOOGLEAPIKEY)

Default model is google/gemini-3-flash-preview if none is set.

Useful Flags

• --length short|medium|long|xl|xxl|<chars> — control summary length
• --max-output-tokens <count> — hard token limit
• --extract-only — extract raw text without summarizing (URLs only)
• --json — machine-readable output
• --firecrawl auto|off|always — fallback extraction for blocked sites
• --youtube auto — Apify fallback if APIFYAPITOKEN is set

Config

Optional config file: ~/.summarize/config.json

{ "model": "openai/gpt-5.2" }

Optional services:

• FIRECRAWLAPIKEY for blocked sites
• APIFYAPITOKEN for YouTube fallback