Installation

Install script (recommended)Copy Anchor Link

Installs the latest prebuilt binary for your OS/arch, with no Go toolchain required:

curl -sSfL https://raw.githubusercontent.com/piyush-gambhir/es-cli/main/install.sh | sh

Pin a version or change the install directory:

curl -sSfL https://raw.githubusercontent.com/piyush-gambhir/es-cli/main/install.sh | VERSION=0.1.7 sh
curl -sSfL https://raw.githubusercontent.com/piyush-gambhir/es-cli/main/install.sh | INSTALL_DIR=~/.local/bin sh

Download a release manuallyCopy Anchor Link

Prebuilt binaries are attached to each GitHub Release. Download the archive for your OS/arch, extract it, and put es on your PATH.

Assets are named es-cli_<os>_<arch>.tar.gz, where <os> is darwin or linux and <arch> is amd64 or arm64. Windows ships as es-cli_windows_amd64.zip.

Build from sourceCopy Anchor Link

Requires a Go toolchain:

git clone https://github.com/piyush-gambhir/es-cli.git
cd es-cli/cli-go && make install

The binary is es.

VerifyCopy Anchor Link

es version

UpdatingCopy Anchor Link

es update                  # show the new version, ask, then install it
es update --yes            # install without asking
es update --check          # only report current and latest versions
es update --check -o json  # the same, for scripts

es update works on macOS, Linux, and Windows. It downloads the release archive for your OS/arch, verifies its SHA-256 checksum against the release's checksums.txt, and replaces the binary in place. On Windows, the running es.exe is renamed to es.exe.old, which the next run deletes. If anything fails, the current binary keeps working.

If the binary's directory is not writable, es update stops before downloading: re-run it with sudo, or reinstall with the install script into a writable directory (INSTALL_DIR=~/.local/bin). A binary built with make install into a Go bin directory is not replaced; run git pull && make install in your checkout.

Update noticeCopy Anchor Link

When a newer release exists, other commands print a short notice on stderr after their own output, at most once a day per release:

A new version of es is available: v0.1.9 -> v0.1.10
Update with: es update
Release notes: https://github.com/piyush-gambhir/es-cli/releases/tag/v0.1.10

The check runs in the background, at most once a day. If a command finishes before GitHub answers, it waits up to one second for the answer, so that day's notice is not lost; every other run never waits. It only happens in an interactive terminal: nothing is checked or printed when stderr is not a terminal, when CI is set, or with --quiet. Turn it off with ES_NO_UPDATE_NOTIFIER=1 or NO_UPDATE_NOTIFIER=1.