.TH TLDR 1 "January 2025" "tldr 0.1.0" "User Commands"
.SH NAME
tldr \- download and summarize webpages using LLMs
.SH SYNOPSIS
.B tldr
.RI [ OPTIONS ]
.I URL
.SH DESCRIPTION
.B tldr
fetches webpage content and generates a concise summary using a large language model.
It supports multiple LLM providers through the multillm library.
.SH OPTIONS
.TP
.BR \-m ", " \-\-model " " \fIMODEL\fR
Model to use for summarization (required). Format: provider/model.
.br
Examples: anthropic/sonnet, openai/gpt-4o, gemini/flash, claude/sonnet
.TP
.BR \-p ", " \-\-proxy " " \fIURL\fR
Proxy URL for HTTP requests (e.g., http://proxy:8080).
.TP
.BR \-H ", " \-\-header " " \fIHEADER\fR
HTTP header in "Name: Value" format. Can be specified multiple times.
.TP
.BR \-n ", " \-\-nodriver
Use nodriver (headless browser by default) to fetch JavaScript-rendered pages.
Incompatible with \fB\-\-header\fR. Supports \fB\-\-proxy\fR.
.TP
.BR \-d ", " \-\-debug
Show browser window when using \fB\-\-nodriver\fR (disables headless mode).
.TP
.BR \-r ", " \-\-raw
Output raw extracted text instead of LLM summary.
.TP
.BR \-h ", " \-\-help
Show help message and exit.
.SH ENVIRONMENT
API keys are read from environment variables by the respective providers:
.TP
.B ANTHROPIC_API_KEY
API key for Anthropic models.
.TP
.B OPENAI_API_KEY
API key for OpenAI models.
.TP
.B GEMINI_API_KEY
API key for Google Gemini models.
.TP
.B OPENROUTER_API_KEY
API key for OpenRouter models.
.SH EXAMPLES
Summarize a webpage using Claude:
.PP
.RS
.nf
tldr https://example.com -m anthropic/sonnet
.fi
.RE
.PP
Summarize using OpenAI GPT-4o:
.PP
.RS
.nf
tldr https://example.com -m openai/gpt-4o
.fi
.RE
.PP
Fetch a JavaScript-heavy page:
.PP
.RS
.nf
tldr https://example.com --nodriver -m claude/sonnet
.fi
.RE
.PP
Use a proxy:
.PP
.RS
.nf
tldr https://example.com --proxy http://localhost:8080 -m gemini/flash
.fi
.RE
.PP
Add custom headers:
.PP
.RS
.nf
tldr https://example.com -H "Authorization: Bearer token" -m anthropic/sonnet
.fi
.RE
.PP
Output raw text without summarization:
.PP
.RS
.nf
tldr https://example.com --raw
.fi
.RE
.PP
Debug mode (show browser window):
.PP
.RS
.nf
tldr https://example.com --nodriver --debug -m claude/sonnet
.fi
.RE
.SH SEE ALSO
.BR curl (1),
.BR wget (1)
.SH AUTHORS
Louis Burda