Skip to content

Installation＃

kluster.ai's CLI is available for macOS, Linux, and Windows. The installer downloads a single binary, adds it to your PATH, and you're ready to go. This page covers installation, updates, shell completions, and uninstalling.

Install kluster-cli＃

Run the following command in your terminal:

curl -fsSL https://cli.kluster.ai/install.sh | sh

curl -fsSL https://cli.kluster.ai/install.sh | sh Downloading kluster-cli... Installing to ~/.kluster/cli/bin/kluster... ✅ kluster-cli installed successfully Run 'kluster login' to authenticate

The installer places the binary at ~/.kluster/cli/bin/kluster and adds it to your PATH.

Installer options:

Flag Description
-b <dir> Custom install directory (default: ~/.kluster/cli/bin).
-d Enable debug logging.
-q Quiet mode (errors only).
-n Dry run (no changes).

Run the following command in PowerShell:

irm https://cli.kluster.ai/install.ps1 | iex

irm https://cli.kluster.ai/install.ps1 | iex Downloading kluster-cli... Installing to %USERPROFILE%.kluster\cli\bin\kluster.exe... ✅ kluster-cli installed successfully Run 'kluster login' to authenticate

The installer places the binary at %USERPROFILE%\.kluster\cli\bin\kluster.exe and adds it to your PATH.

Verify installation＃

After installation, verify the CLI is working:

kluster version
kluster version kluster.ai CLI version 0.1.2 commit: a1b2c3d4e5f6a7b8 built: 2026-02-01T10:30:00Z go: go1.24.0 os/arch: darwin/arm64

If you get command not found: kluster, your PATH likely wasn't updated. See Troubleshooting.

Login＃

Authenticate the CLI with your API key:

kluster login
kluster login Get your API key at: https://platform.kluster.ai/cli Enter your API key: ************************************ → Validating API key... ✓ Successfully authenticated Time to ship better code, try one of these: kluster review staged # Review staged changes kluster hooks install pre-push # Auto-review on git push/commit

Get your API key from the CLI setup page.

To authenticate non-interactively (useful for CI/CD):

kluster login --api-key kl_your_key_here

To remove stored credentials:

kluster logout

Supported platforms＃

OS Architectures
Linux amd64, arm64
macOS amd64 (Intel), arm64 (Apple Silicon)
Windows amd64, arm64

Update＃

The CLI can update itself to the latest version:

kluster update
kluster update → Checking for updates... Current version: v0.1.0 Latest version: v0.1.2 → Updating to v0.1.2... → Downloading... → Checksum verified ✓ Successfully updated to v0.1.2

To check if an update is available without installing:

kluster update --check
kluster update --check → Checking for updates... ✓ Already up to date (v0.1.2)

The update process downloads the latest binary, verifies its SHA256 checksum, and replaces the current installation.

Uninstall＃

To remove kluster-cli, delete the installation directory:

rm -rf ~/.kluster/cli

Remove-Item -Recurse -Force "$env:USERPROFILE\.kluster\cli"

Shell completions (optional)＃

Enable tab completion for commands, flags, and git branches.

# Current session only
source <(kluster completion bash)

# Permanent (Linux, requires sudo)
kluster completion bash | sudo tee /etc/bash_completion.d/kluster > /dev/null

# Permanent (macOS with Homebrew)
kluster completion bash > "$(brew --prefix)/etc/bash_completion.d/kluster"

# Enable completions if not already
echo "autoload -U compinit; compinit" >> ~/.zshrc

# Add completion
kluster completion zsh > "${fpath[1]}/_kluster"

# Or source directly
echo 'source <(kluster completion zsh)' >> ~/.zshrc

# Current session only
kluster completion fish | source

# Permanent
kluster completion fish > ~/.config/fish/completions/kluster.fish

# Current session only
kluster completion powershell | Out-String | Invoke-Expression

# Permanent (add to profile)
kluster completion powershell >> $PROFILE

Next steps＃

  • Quickstart: Run your first review from the terminal.
  • Review commands: All review options and output formats.
  • Reference: Configuration, exit codes, and full command reference.