One Tip a Week: tlrc

This week’s tip of the week is tlrc.

tlrc is a modern Rust-based client for tldr pages, the community-driven project that provides simplified, example-based man pages. Instead of digging through lengthy docs, you get just the practical commands you need.

Installing tlrc provides the tldr command, replacing the old client that will be retired at the end of October 2025, in case you happen to have `tldr` installed already.

Here it is in action for caffeinate, a CLI command for macOS that was a tip back from August.

❯ tldr caffeinate
warning: 1 page(s) found for other platforms:
1. linux (tldr --platform linux caffeinate)

  caffeinate

  Prevent macOS from sleeping.
  More information:
  https://keith.github.io/xcode-man-pages/caffeinate.8.html.

  Prevent the display from sleeping:

    caffeinate -d

  Prevent from sleeping for 1 hour (3600 seconds):

    caffeinate -u -t 3600

  Fork a process, exec "make" in it, and prevent sleep as long as that process
  is running:

    caffeinate -i make

  Prevent from sleeping until a process with the specified PID completes:

    caffeinate -w pid

  Prevent disk from sleeping (use <Ctrl c> to exit):

    caffeinate -m

You immediately get common usage examples like how to prevent your Mac from sleeping for one hour, caffeinate -u -t 3600.

Why tlrc?

  • Written in Rust so it’s fast, portable, and reliable if that’s your jam.

  • Offline caching for when you’re not connected. I’m looking at you train tunnels!

  • Syntax highlighting for command examples.

  • Maintained and actively supported.

That’s it! Short and sweet. Until the next one!