Erreur32 12799fd266 Update 2 years ago
bin fec0382892 Update cheat 2 years ago
cheat 6e36b13df7 Update 2 years ago
licenses a063c7bb64 Licensing 4 years ago
man1 354376340f Missing man page #272 3 years ago
.gitignore 718ec4f685 Resolves #207 5 years ago fb5ec798fa 2 years ago
LICENSE a063c7bb64 Licensing 4 years ago e8d32102cb Create 3 years ago 12799fd266 Update 2 years ago 71e5bd53a3 Update 2 years ago

Original project

Fork Verion cheapy

Features added by by πŸ…΄πŸ†πŸ†πŸ…΄πŸ†„πŸ†32 :

  • Add color seach and prompt
  • Add Subdir creation and search
  • Add remove sheet file (-r) with confirmation
  • Add color help text

Origin repo

Mirror repo

Put in your bashrc

function _cheat_autocomplete {
    sheets=$(cheat -l | cut -d' ' -f1)
    if [ $COMP_CWORD = 1 ]; then
	COMPREPLY=(`compgen -W "$sheets" -- $2`)

complete -F _cheat_autocomplete cheat



First, install the dependencies:

[sudo] pip install docopt pygments appdirs

Then clone this repository:

git clone

Lastly, cd into the cloned directory, then run:

[sudo] python install


cheat allows you to create and view interactive cheatsheets on the command-line. It was designed to help remind *nix system administrators of options for commands that they use frequently, but not frequently enough to remember.


The next time you're forced to disarm a nuclear weapon without consulting Google, you may run:

cheat tar

You will be presented with a cheatsheet resembling:

# To extract an uncompressed archive: 
tar -xvf '/path/to/foo.tar'

# To extract a .gz archive:
tar -xzvf '/path/to/foo.tgz'

# To create a .gz archive:
tar -czvf '/path/to/foo.tgz' '/path/to/foo/'

# To extract a .bz2 archive:
tar -xjvf '/path/to/foo.tgz'

# To create a .bz2 archive:
tar -cjvf '/path/to/foo.tgz' '/path/to/foo/'

To see what cheatsheets are available, run cheat -l.

Note that, while cheat was designed primarily for *nix system administrators, it is agnostic as to what content it stores. If you would like to use cheat to store notes on your favorite cookie recipes, feel free.

Modifying Cheatsheets

The value of cheat is that it allows you to create your own cheatsheets - the defaults are meant to serve only as a starting point, and can and should be modified.

Cheatsheets are stored in the ~/.cheat/ directory, and are named on a per-keyphrase basis. In other words, the content for the tar cheatsheet lives in the ~/.cheat/tar file.

Provided that you have a CHEAT_EDITOR, VISUAL, or EDITOR environment variable set, you may edit cheatsheets with:

cheat -e foo

If the foo cheatsheet already exists, it will be opened for editing. Otherwise, it will be created automatically.

After you've customized your cheatsheets, I urge you to track ~/.cheat/ along with your dotfiles.



Personal cheatsheets are saved in the ~/.cheat directory by default, but you can specify a different default by exporting a DEFAULT_CHEAT_DIR environment variable:

export DEFAULT_CHEAT_DIR='/path/to/my/cheats'


You can additionally instruct cheat to look for cheatsheets in other directories by exporting a CHEATPATH environment variable:

export CHEATPATH='/path/to/my/cheats'

You may, of course, append multiple directories to your CHEATPATH:

export CHEATPATH="$CHEATPATH:/path/to/more/cheats"

You may view which directories are on your CHEATPATH with cheat -d.

Enabling Syntax Highlighting

cheat can optionally apply syntax highlighting to your cheatsheets. To enable syntax highlighting, export a CHEATCOLORS environment variable:

export CHEATCOLORS=true

Specifying a Syntax Highlighter

You may manually specify which syntax highlighter to use for each cheatsheet by wrapping the sheet's contents in a Github-Flavored Markdown code-fence.


-- to select a user by ID
FROM Users
WHERE id = 100

If no syntax highlighter is specified, the bash highlighter will be used by default.

See Also: