Install Clever Tools

Clever Tools is available as a npm package, through package managers, or as a standalone binary on many systems:

• Node.js
  • npm
  • pnpm
  • Bun
  • Yarn
• GNU/Linux
  • Arch Linux (AUR)
  • CentOS/Fedora (.rpm)
  • Debian/Ubuntu (.deb)
  • Exherbo
  • Other distributions (.tar.gz)
• macOS
  • Homebrew
  • Binary (.tar.gz)
• Windows
  • WinGet
  • Binary (.zip)
• Docker
  • Dockerfile
• Nix package manager
• Enabling autocompletion

To upgrade an existing installation, follow the update guide.

Node.js

Clever Tools is available as a npm package, which requires Node.js 24 or later. Install it globally with the package manager you use.

npm

npm install -g clever-tools

pnpm

pnpm add -g clever-tools

Bun

bun add -g clever-tools

Yarn

yarn global add clever-tools

GNU/Linux

Arch Linux (AUR)

If you use Arch Linux, install Clever Tools from AUR. Two packages are available. They provide the same clever command, so you can’t install both side by side:

• clever-tools: the Node.js flavor, it runs on the nodejs package of your system
• clever-tools-bin: a self-contained binary, with no runtime dependency

If you use an AUR helper like yay, run:

yay -S clever-tools

Or, for the self-contained binary:

yay -S clever-tools-bin

CentOS/Fedora (.rpm)

If you use a GNU/Linux distribution that uses .rpm packages like CentOS or Fedora, run:

curl -s https://clever-tools.clever-cloud.com/repos/cc-nexus-rpm.repo > /etc/yum.repos.d/cc-nexus-rpm.repo
yum update
yum install clever-tools

Debian/Ubuntu (.deb)

If you use a GNU/Linux distribution that uses .deb packages like Debian or Ubuntu, run:

curl -fsSL https://clever-tools.clever-cloud.com/gpg/cc-nexus-deb.public.gpg.key | gpg --dearmor -o /usr/share/keyrings/cc-nexus-deb.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/cc-nexus-deb.gpg] https://nexus.clever-cloud.com/repository/deb stable main" | tee -a /etc/apt/sources.list
apt update
apt install clever-tools

Exherbo

If you are using Exherbo, run:

cave resolve repository/CleverCloud -zx1
cave resolve clever-tools-bin -zx

Other distributions (.tar.gz)

If you use another GNU/Linux distribution, download the .tar.gz archive and extract the binary in your PATH:

curl -O https://clever-tools.clever-cloud.com/releases/latest/clever-tools-latest_linux.tar.gz
tar xvzf clever-tools-latest_linux.tar.gz
cp clever-tools-latest_linux/clever ~/.local/bin/

macOS

Clever Tools only provides macOS binaries for Apple Silicon processors. On an Intel Mac, use the npm package.

Homebrew

If you use macOS and you have Homebrew installed, run:

brew install CleverCloud/homebrew-tap/clever-tools

Binary (.tar.gz)

If you use macOS, but you don’t have Homebrew installed, download the .tar.gz archive and extract the binary in your PATH:

curl -O https://clever-tools.clever-cloud.com/releases/latest/clever-tools-latest_macos.tar.gz
tar xvzf clever-tools-latest_macos.tar.gz
cp clever-tools-latest_macos/clever ~/.local/bin/

Windows

WinGet

If you use Windows run in a terminal:

winget install CleverTools

Binary (.zip)

You can also download the .zip archive and extract the binary in your PATH:

Invoke-WebRequest https://clever-tools.clever-cloud.com/releases/latest/clever-tools-latest_win.zip -OutFile clever-tools-latest_win.zip
Expand-Archive .\clever-tools-latest_win.zip -DestinationPath .
$env:PATH += ";$(Resolve-Path .\clever-tools-latest_win\)"

Docker

If you are using Docker, use the Clever Tools image from Docker Hub.

docker pull clevercloud/clever-tools
docker run --rm clevercloud/clever-tools version

Dockerfile

In your Dockerfile copy clever-tools from the image itself with a simple one liner:

COPY --from=clevercloud/clever-tools /bin/clever /usr/local/bin/clever

Nix package manager

If you are using Nix on NixOS or any other compatible system, the package is available in both stable and unstable channels. Follow these instructions.

Enabling autocompletion

The clever-tools CLI comes with a comprehensive auto-completion system. Some installation methods through package managers will try to enable it automatically. If not, use this for bash:

clever --bash-autocomplete-script $(which clever) | sudo tee /usr/share/bash-completion/completions/clever

or that for zsh:

clever --zsh-autocomplete-script $(which clever) | sudo tee /usr/share/zsh/site-functions