Git/cheat

mirror of https://github.com/cheat/cheat.git synced 2026-03-07 03:03:32 +01:00

Files

Christopher Allen Lane 80e0e0d3ae feat: add --update/-u flag to pull git-backed cheatpaths (#552 )

Iterates over configured cheatpaths and runs git pull on each one that
is a git repository with a clean worktree. Supports SSH remotes via key
file discovery and SSH agent fallback. Works with --path filtering.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-15 19:51:40 -05:00

2.9 KiB

Raw Blame History

Installing

cheat has no runtime dependencies. As such, installing it is generally straightforward. There are a few methods available:

Install manually

Unix-like

On Unix-like systems, you may simply paste the following snippet into your terminal:

cd /tmp \
  && wget https://github.com/cheat/cheat/releases/download/5.0.0/cheat-linux-amd64.gz \
  && gunzip cheat-linux-amd64.gz \
  && chmod +x cheat-linux-amd64 \
  && sudo mv cheat-linux-amd64 /usr/local/bin/cheat

You may need to need to change the version number (5.0.0) and the archive (cheat-linux-amd64.gz) depending on your platform.

See the releases page for a list of supported platforms.

Windows

On Windows, download the appropriate binary from the releases page, unzip the archive, and place the cheat.exe executable on your PATH.

Install via `go install`

If you have go version >=1.26 available on your PATH, you can install cheat via go install:

go install github.com/cheat/cheat/cmd/cheat@latest

Install via package manager

Several community-maintained packages are also available:

Package manager	Package(s)
aur	cheat, cheat-bin
brew	cheat
docker	docker-cheat
nix	nixos.cheat
snap	cheat

Configuring

Three things must be done before you can use cheat:

A config file must be generated
cheatpaths must be configured
Community cheatsheets must be downloaded

On first run, cheat will run an installer that will do all of the above automatically. After the installer is complete, it is strongly advised that you view the configuration file that was generated, as you may want to change some of its default values (to enable colorization, change the paginator, etc).

conf.yml

cheat is configured by a YAML file that will be auto-generated on first run.

By default, the config file is assumed to exist on an XDG-compliant configuration path like ~/.config/cheat/conf.yml. If you would like to store it elsewhere, you may export a CHEAT_CONFIG_PATH environment variable that specifies its path:

export CHEAT_CONFIG_PATH="~/.dotfiles/cheat/conf.yml"

2.9 KiB Raw Blame History