1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
.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
|
