The tldr-pages project is a collection of community-maintained help pages for command-line tools, that aims to be a simpler, more approachable complement to traditional man pages.

Maybe you're new to the command-line world. Perhaps you're just a little rusty or can't always recall the arguments for commands like lsof, or tar?

It certainly doesn't help that, in the past, the first option explained in man tar was:

$ man tar
...
-b blocksize
   Specify the block size, in 512-byte records, for tape drive I/O.
   As a rule, this argument is only needed when reading from or writing to tape drives,
   and usually not even then as the default block size of 20 records (10240 bytes) is very common.
...

There is room for simpler help pages focused on practical examples. How about:

This repository is just that: an ever-growing collection of examples for the…

jq is a lightweight and flexible command-line JSON processor akin to sed,awk,grep, and friends for JSON data. It's written in portable C and has zero runtime dependencies, allowing you to easily slice, filter, map, and transform structured data.

• Official Documentation: jqlang.org
• Try jq Online: play.jqlang.org

Download the latest releases from the GitHub release page.

Pull the jq image to start quickly with Docker.

docker run --rm -i ghcr.io/jqlang/jq:latest < package.json '.version'

docker run --rm -i -v "$PWD:$PWD" -w "$PWD" ghcr.io/jqlang/jq:latest '.version' package.json

• libtool
• make
• automake
• autoconf

git submodule update --init    # if building from git to get

direnv is an extension for your shell. It augments existing shells with a new feature that can load and unload environment variables depending on the current directory.

• Load 12factor apps environment variables
• Create per-project isolated development environments
• Load secrets for deployment

Before each prompt, direnv checks for the existence of a .envrc file (and optionally a .env file) in the current and parent directories. If the file exists (and is authorized), it is loaded into a bash sub-shell and all exported variables are then captured by direnv and then made available to the current shell.

It supports hooks for all the common shells like bash, zsh, tcsh and fish. This allows project-specific environment variables without cluttering the ~/.profile file.

Because direnv is compiled into a single static executable, it is fast enough to be unnoticeable on each prompt. It is…

tmux is a terminal multiplexer: it enables a number of terminals to be created accessed, and controlled from a single screen. tmux may be detached from a screen and continue running in the background, then later reattached.

This release runs on OpenBSD, FreeBSD, NetBSD, Linux, macOS and Solaris.

tmux depends on libevent 2.x, available from this page.

It also depends on ncurses, available from this page.

To build tmux, a C compiler (for example gcc or clang), make, pkg-config and a suitable yacc (yacc or bison) are needed.

Some platforms provide binary packages for tmux, although these are sometimes out of date. Examples are listed on this page.

To build and install tmux from a release tarball, use:

./configure && make
sudo make install

tmux can use the utempter library to update utmp(5), if it is…

how2 finds the simplest way to do something in a unix shell It's like man, but you can query it in natural language. It uses a mix of AI code-completion and StackOverflow search.

It effectively replaces Chrome => New Tab => Google => Click on StackOverflow => Scroll Down to first answer.

Go to how2terminal.com for more info.

brew tap how2terminal/how2
brew install how2

sudo npm install -g how2

If you install it without sudo, then you have to run it with npx how2 or alias the command manually.

Download latest .deb and then run:

wget how2terminal.com/how2.deb
sudo dpkg -i how2.deb

Go to the latest release and download the binaries.

By default, how2 uses an external AI server to find the best unix command line suggestion If you add the -s…

ripgrep is a line-oriented search tool that recursively searches the current directory for a regex pattern. By default, ripgrep will respect gitignore rules and automatically skip hidden files/directories and binary files. (To disable all automatic filtering by default, use rg -uuu.) ripgrep has first class support on Windows, macOS and Linux, with binary downloads available for every release. ripgrep is similar to other popular search tools like The Silver Searcher, ack and grep.

Dual-licensed under MIT or the UNLICENSE.

Please see the CHANGELOG for a release history.

• Installation
• User Guide
• Frequently Asked Questions
• Regex syntax
• Configuration files
• Shell completions
• Building
• Translations

This example searches the entire Linux kernel source tree (after running make defconfig && make -j8) for [A-Z]+_SUSPEND, where all matches must be words. Timings were collected on a system…

A cat(1) clone with syntax highlighting and Git integration

Key Features • How To Use • Installation • Customization • Project goals, alternatives
[English] [中文] [日本語] [한국어] [Русский]

bat supports syntax highlighting for a large number of programming and markup languages:

bat communicates with git to show modifications with respect to the index (see left sidebar):

You can use the -A/--show-all option to show and highlight non-printable characters:

By default, bat pipes its own output to a pager (e.g. less) if the output is too large for one screen If you would rather bat work like cat all the time (never page output), you can set --paging=never as an option, either on the command line or in your configuration file. If you intend to alias cat to bat in your…

Show your love for fzf -- T-shirts, mugs, and stickers now available

commitgoods.com/collections/fzf

fzf is a general-purpose command-line fuzzy finder.

It's an interactive filter program for any kind of list; files, command history, processes, hostnames, bookmarks, git commits, etc. It implements a "fuzzy" matching algorithm, so you can quickly type in patterns with omitted characters and still get the results you want.

• Portable -- Distributed as a single binary for easy installation
• Fast -- Optimized to process millions of items instantly
• Versatile -- Fully customizable through an event-action binding mechanism
• All-inclusive -- Comes with integrations for Bash, Zsh, Fish, Vim, and Neovim

• Installation
  • Using Homebrew
  • Using Mise
  • Linux packages
  • Windows packages
  • Using git
  • Binary releases
  • Setting up shell integration
  • Vim/Neovim plugin
• Upgrading fzf
• Building fzf
• Usage
  • Using the finder
  • Display modes
    • --height mode
    • --popup mode
  • Search syntax
  • Environment variables
  • Customizing the look
  • Options
  • Demo
• Examples
• Key…

[中文] [한국어]

fd is a program to find entries in your filesystem It is a simple, fast and user-friendly alternative to find While it does not aim to support all of find's powerful functionality, it provides sensible (opinionated) defaults for a majority of use cases.

Installation • How to use • Troubleshooting

• Intuitive syntax: fd PATTERN instead of find -iname '*PATTERN*'.
• Regular expression (default) and glob-based patterns.
• Very fast due to parallelized directory traversal.
• Uses colors to highlight different file types (same as ls).
• Supports parallel command execution
• Smart case: the search is case-insensitive by default. It switches to case-sensitive if the pattern contains an uppercase character*.
• Ignores hidden directories and files, by default.
• Ignores patterns from your .gitignore, by default.
• The command name is 50% shorter* than find :-).

First, to…

autojump - a faster way to navigate your filesystem

autojump is a faster way to navigate your filesystem. It works by maintaining a database of the directories you use the most from the command line.

Directories must be visited first before they can be jumped to.

j is a convenience wrapper function around autojump. Any option that can be used with autojump can be used with j and vice versa.

• Jump To A Directory That Contains foo:

  j foo
  

• Jump To A Directory That Contains foo, Preferring Child Directories:

  You can prioritize child directories over matches in the databases via

  jc foo
  

• Open File Manager To Directories (instead of jumping):

  Instead of jumping to a directory, you can open a file explorer window (Mac Finder, Windows Explorer, GNOME Nautilus, etc.) to the directory instead.

  jo music
  

  Opening a file manager to a child directory…

https://ngrok.com

If you are having an issue with the ngrok cloud service please open an issue on the ngrok community on GitHub

This is the GitHub repository for the old v1 version of ngrok which was actively developed from 2013-2016.

This repository is archived: ngrok v1 is no longer developed, supported or maintained.

Thank you to everyone who contributed to ngrok v1 it in its early days with PRs, issues and feedback. If you wish to continue development on this codebase, please fork it.

ngrok's cloud service continues to operate and you can sign up for it here: https://ngrok.com/signup

ngrok is a globally distributed reverse proxy that secures, protects and accelerates your applications and network services, no matter where you run them. You can think of ngrok as the front door to your…

hub is a command line tool that wraps git in order to extend it with extra features and commands that make working with GitHub easier.

For an official, potentially more user-friendly command-line interface to GitHub see cli.github.com and this comparison.

This repository and its issue tracker is not for reporting problems with GitHub.com web interface. If you have a problem with GitHub itself, please contact Support.

$ hub clone rtomayko/tilt
#=> git clone https://github.com/rtomayko/tilt.git

# or, if you prefer the SSH protocol:
$ git config --global hub.protocol ssh
$ hub clone rtomayko/tilt
#=> git clone git@github.com:rtomayko/tilt.git

See usage examples or the full reference documentation to see all available commands and flags.

hub can also be used to make shell scripts that directly interact with the GitHub API.

hub can be safely aliased as git, so you can type $ git <command> in the…

A starter project to build command-line tools in Kotlin Multiplatform

Contains a re-implementation of a real world CLI tool: git-standup

You can install using one of the options listed below

Being able to write your own command-line tools is a great skill to have. Automate all the things!

You can write the CLI tools in Kotlin and reap the benefits of using

• a modern programming language
• modern IDE support
• modern practices such as unit testing and continuous integration
• leverage Kotlin multiplatform libraries
• run your code on the JVM and benefit from a wealth of Java libraries
• or build a native executable, which starts very fast and…

^{Special thanks to:}

Warp, the intelligent terminal
Available for macOS and Linux

^{Visit warp.dev to learn more.}

---

Tuple, the premier screen sharing app for developers on macOS and Windows.

---

I (Jesse) co-founded Subble to save your company time and money by finding unused and over-provisioned SaaS licences. Check it out!

---

Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here. 💙

Rant time: You've heard it before, git is powerful, but what good is that power when everything is so damn hard to do? Interactive rebasing requires you to edit a goddamn TODO file in your editor? Are you kidding me? To stage part of a file you need to use a command line program to…

just is a handy way to save and run project-specific commands.

This readme is also available as a book. The book reflects the latest release, whereas the readme on GitHub reflects latest master.

(中文文档在 这里 快看过来!)

Commands, called recipes, are stored in a file called justfile with syntax inspired by make:

You can then run them with just RECIPE:

$ just test-all
cc *.c -o main
./test --all
Yay, all your tests passed!

just has a ton of useful features, and many improvements over make:

• just is a command runner, not a build system, so it avoids much of make's complexity and idiosyncrasies No need for .PHONY recipes!

• Linux, macOS, Windows, and other reasonable unixes are supported with no additional dependencies. (Although if your system doesn't have an sh you'll need to choose a different shell.)

• …

[releases]

Jump integrates with your shell and learns where you go. It tracks the directories you visit and lets you jump to the right one with just a few fuzzy-typed characters.

Packages are available on the following platforms:

Jump is used through its helper function – j by default. Add it to your shell:

bash / zsh

eval "$(jump shell)"

fish

jump shell fish | source

PowerShell

Invoke-Expression (&jump shell pwsh | Out-String)

Nushell

jump shell nushell | save --append $nu.config-path

Murex

murex-package install https://github.com/lmorg/murex-module-jump.git

Jump begins…