xevol

Transcribe, analyze, and explore YouTube content from your terminal.

Paste a YouTube URL, get AI-powered transcription and analysis — no API keys, no local GPU, no tool chaining.

Quick Demo

$ xevol add https://youtube.com/watch?v=oOylEw3tPQ8 --analyze facts

⠋ Processing... (12s)
✔ "Cursor CEO: Going Beyond Code" (37:29)

─── facts ───
• Cursor reached $100M ARR in 20 months
• 40-50% of code in Cursor is AI-generated
• Team hired first 10 employees over 6 months deliberately
• Pivoted from AI-CAD to AI coding tools

✔ Done

Installation

npm install -g xevol

Or run without installing:

npx xevol

or install with brew:

brew install xevol/tap/xevol

Requires Node.js 18+.

Quick Start

# 1. Authenticate
xevol login

# 2. Add a YouTube video (waits for completion by default)
xevol add "https://youtube.com/watch?v=abc123"

# 3. Analyze it
xevol analyze <id> --prompt facts

# 4. View the transcript
xevol view <id>

Commands

| Command | Description | | --------- | ----------------------------------------------- | | login | Authenticate via device flow (opens browser) | | logout | Clear stored credentials | | whoami | Show current user, plan, and usage | | add | Add a YouTube URL for transcription | | list | List your transcriptions | | locations | List your Xevol Coordinates location history | | view | View a transcription summary or full transcript | | analyze | Generate AI analysis using a prompt | | prompts | List available analysis prompts | | stream | Stream analysis output via SSE | | resume | Resume a previous streaming session | | config | View or edit CLI configuration |

All commands support --json for machine-readable output.

Command Details

xevol login

Authenticate using the device code flow — opens your browser, you confirm, done.

# Interactive device flow
xevol login

# Token-based (CI / headless)
xevol login --token <token>

# Or set via environment variable
export XEVOL_TOKEN=<token>

xevol add

Add a YouTube video for transcription.

# Add and wait for transcription (default)
xevol add "https://youtube.com/watch?v=abc123"

# Fire-and-forget (returns ID immediately)
xevol add "https://youtube.com/watch?v=abc123" --no-wait

# Specify language
xevol add "https://youtube.com/watch?v=abc123" --lang de

# Transcribe and analyze in one step
xevol add "https://youtube.com/watch?v=abc123" --analyze facts

# Analyze with multiple prompts
xevol add "https://youtube.com/watch?v=abc123" --analyze facts,advice

# Stream analysis output in real time
xevol add "https://youtube.com/watch?v=abc123" --analyze facts --stream

| Flag | Description | | --------------------- | ----------------------------------------------------- | | --no-wait | Return immediately without waiting | | --lang <code> | Language code (e.g. en, de, ja) | | --analyze <prompts> | Comma-separated prompt IDs to run after transcription | | --stream | Stream analysis output via SSE | | --json | JSON output |

xevol list

List your transcriptions.

# Default table view
xevol list

# Pagination
xevol list --page 2 --limit 50

# Filter by status
xevol list --status completed

# Machine-readable formats
xevol list --json
xevol list --csv

| Flag | Description | | -------------- | ---------------- | | --page <n> | Page number | | --limit <n> | Results per page | | --status <s> | Filter by status | | --json | JSON output | | --csv | CSV output |

xevol locations

List your location history from Xevol Coordinates.

# Default view
xevol locations

# Pagination
xevol locations --page 2 --limit 50

# Filter by time window
xevol locations --since 2026-01-01T00:00:00Z --until 2026-01-31T23:59:59Z

# Include exact latitude/longitude
xevol locations --exact

# Machine-readable formats
xevol locations --json
xevol locations --csv

| Flag | Description | | --------------- | ------------------------------------------- | | --page <n> | Page number | | --limit <n> | Results per page | | --since <iso> | Include records at/after this ISO datetime | | --until <iso> | Include records at/before this ISO datetime | | --exact | Include exact latitude/longitude columns | | --json | JSON output | | --csv | CSV output |

xevol view

View a transcription's summary or full transcript.

# Summary view
xevol view abc123def45

# Full transcript (pipe-friendly)
xevol view abc123def45 --raw

# Clean transcript (processed content)
xevol view abc123def45 --clean

# JSON output
xevol view abc123def45 --json

| Flag | Description | | --------- | ------------------------------ | | --raw | Print the full transcript text | | --clean | Use cleaned/processed content | | --json | JSON output |

xevol analyze

Generate AI-powered analysis of a transcription.

# Analyze with a specific prompt
xevol analyze abc123def45 --prompt facts

# Use a different language for output
xevol analyze abc123def45 --prompt facts --lang de

# JSON output
xevol analyze abc123def45 --prompt facts --json

| Flag | Description | | --------------- | --------------------------------- | | --prompt <id> | Prompt to use (default: review) | | --lang <code> | Output language | | --json | JSON output |

Use xevol prompts to see all available prompts.

xevol prompts

List available analysis prompts.

xevol prompts
xevol prompts --json
xevol prompts --csv

xevol stream

Stream analysis output in real time via SSE.

xevol stream <spike-id>
xevol stream <spike-id> --last-event-id <id>

xevol resume

Resume a previously interrupted streaming session.

xevol resume <transcription-id>

xevol config

View or edit CLI configuration.

# Show all config
xevol config

# Get a value
xevol config get apiUrl

# Set a value
xevol config set default.lang de
xevol config set default.limit 50

Available config keys:

| Key | Description | | --------------- | ---------------------------- | | apiUrl | Base API URL | | default.lang | Default output language | | default.limit | Default page size for list | | api.timeout | API request timeout (ms) |

Output Formats

Table (default)

┌─────────────┬────────────────────────────────┬──────────┬──────────┐
│ ID          │ Title                          │ Duration │ Status   │
├─────────────┼────────────────────────────────┼──────────┼──────────┤
│ abc123def45 │ Cursor CEO: Going Beyond Code  │ 37:29    │ ✔ done   │
│ xyz789ghi01 │ Naval on Happiness             │ 12:03    │ ⠋ proc…  │
└─────────────┴────────────────────────────────┴──────────┴──────────┘

JSON (--json)

xevol list --json | jq '.list[] | select(.channelTitle == "Y Combinator")'
xevol analyze abc123 --prompt facts --json | jq '.spikes[0].content'

CSV (--csv)

xevol list --csv > transcriptions.csv
xevol prompts --csv

Streaming

Analysis output streams in real time via Server-Sent Events (SSE). Use --stream with add to watch analysis as it's generated:

xevol add "https://youtube.com/watch?v=..." --analyze facts --stream

If a stream is interrupted, resume it:

xevol resume <transcription-id>

Authentication

xevol uses a device authorization flow, similar to gh auth login:

1. Run xevol login
2. A code is displayed and your browser opens
3. Enter the code to authorize
4. The CLI stores your token locally at ~/.xevol/

For CI/CD or headless environments, use token-based auth:

xevol login --token <token>
# or
export XEVOL_TOKEN=<token>

Check your auth status:

xevol whoami

Piping & Scripting

# Pipe transcript to other tools
xevol view <id> --raw | wc -w

# JSON output for scripting
xevol list --json | jq '.list | length'

# Export to CSV
xevol list --csv > my-transcriptions.csv

Global Options

| Flag | Description | | ----------------- | ---------------------------------------- | | --token <token> | Override auth token for a single command | | --no-color | Disable colored output | | --json | Machine-readable JSON output | | -V, --version | Print version | | -h, --help | Show help |

Links

• Website: xevol.com
• Issues: github.com/xevol/xevol-cli/issues

License

Proprietary — see xevol.com for terms.