TLDR(1)

📦
version 3.4.4 · 13 versions
, in arch rolling

💅 NAME 💅

okay so bestie, meet tldr — this is the tldr 3.4.4 era, we're so back. it's the Python command line client for tldr (yes it's the TLDR(1) page you're reading rn, hi, welcome 🫶).

here's the whole vibe in one line:

usage: tldr command [options]

that's it. that's the whole flex. ✨

🌸 POSITIONAL ARGUMENTS 🌸

  • command — the command you wanna look up 👀 like, the thing you're confused about. drop it in, get your little cheat sheet, slay.

🎀 NAMED ARGUMENTS 🎀

so many little flags, all of them iconic in their own way. here we go 👑

  • -v, --version — shows the program's version number and then exits, periodt. 🏃‍♀️
  • --search — search for a specific command from a query 🔍 lowkey the glow-up search mode.
  • -u, --update, --update_cache — updates your local cache of pages and then exits. Default: False.
  • -k, --clear-cache — deletes your local cache of pages and then exits. it's giving fresh start 💀 Default: False.
  • -p, --platform — overrides the operating system. possible choices are: android, freebsd, linux, netbsd, openbsd, osx, sunos, windows, common. so like [android, freebsd, linux, netbsd, openbsd, osx, sunos, windows, common] — pick your fighter 🌈
  • -l, --list — lists all available commands for the operating system 📋 Default: False.
  • -s, --source — overrides the default page source. Default: 'https://raw.githubusercontent.com/tldr-pages/tldr/main/pages' 🦋 (yes that's the whole URL, don't @ me).
  • -c, --color — overrides color stripping 🎨 the rainbow stays, bestie.
  • -r, --render — renders local markdown files 📝 Default: False.
  • -L, --language — overrides the default language 🌍 so you can get your cheat sheets in whatever language you vibe with.
  • -m, --markdown — just prints the plain page file, no frills. Default: False.
  • --short-options — displays shortform options over longform. Default: False.
  • --long-options — displays longform options over shortform. Default: False.
  • --print-completion — prints a shell completion script 🐚 possible choices: bash, zsh, tcsh. auto-complete is literally main character energy.
ngl bestie, -u/-k both also exit right after they do their thing — so don't go chaining a million things after them expecting a whole adventure. 👀

💖 Author 💖

Felix Yan and tldr-pages contributors — shoutout to the whole group chat that made this happen 🫶👑

2014, Felix Yan and 2014-present, tldr-pages contributors — the receipts, preserved forever, no cap. 💜

anyway that's the whole page, go be iconic with it, iykyk 💅✨

🎀 sign-off vibes: this was the tldr page, dated Feb 10, 2026 — mwah, go read some cheat sheets bestie 🌸🦋
📦 where this page comes from