Skip to content
ucliinstall
GitHub

Install ucli

One command builds ucli at its pinned commit and puts it in ~/.local/bin. A new install never asks for sudo.

Install

curl -fsSL https://install.ucli.tools/install.sh | bash

Linux and macOS; on Windows, use WSL. You need curl, git, make and bash. ucli is a bash script, so install bash first if you lack it. If ucli is already in /usr/local/bin, it is updated there, which may ask for your password; ucli install --move moves it to ~/.local/bin.

Read the scriptQuick start

What the installer does

  1. Checks that curl, git, make and bash are installed, and says what to install if not.
  2. Reads the commit the registry pins for ucli, and fetches exactly that commit from github.com/ucli-tools/ucli.
  3. Builds it and puts ucli in ~/.local/bin. A new install never asks for sudo; an existing /usr/local/bin/ucli is updated where it is, which may ask for your password.
  4. Tells you if ~/.local/bin is missing from your PATH, and how to add it for bash, zsh or fish.

Read it before you run it

Download it, read it, check it, then run it:

curl -fsSLO https://install.ucli.tools/install.sh
curl -fsSLO https://install.ucli.tools/install.sh.sha256
less install.sh
sha256sum -c install.sh.sha256
# macOS: shasum -a 256 -c install.sh.sha256
bash install.sh

The check catches a download cut short; it does not protect against a compromised server.

Check that it worked

Open a new terminal and ask ucli for its version. Then build your first tool.

ucli --version
ucli build mdtexpdf

To remove ucli later, run ucli uninstall.