TroubleshootingCLI & Installation

CLI Installation (Linux)

View as Markdown

This guide helps you resolve issues when the Brev CLI installation command completes without output or errors, but the CLI is not installed.

Platform: Linux (reported on Ubuntu 22.04)

Problem

When installing the Brev CLI on Linux using the one-line install command:

$sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/brevdev/brev-cli/main/bin/install-latest.sh)"

The command completes without any output, logs, or error messages, and the Brev CLI is not installed.

Prerequisites

  • Linux system (tested on Ubuntu 22.04)
  • curl installed and available in $PATH
  • Ability to run commands with sudo
  • Outbound network access to raw.githubusercontent.com

Solution

Download and run the install script directly instead of piping through a nested shell.

1

Download the install script

$curl -fsSL https://raw.githubusercontent.com/brevdev/brev-cli/main/bin/install-latest.sh -o install-latest.sh
2

Make the script executable

$chmod +x install-latest.sh
3

Run the script

$./install-latest.sh
4

Check for errors (optional)

If the installation appears to fail silently, capture the exit code:

$echo $?

A non-zero exit code indicates an error occurred.

Verification

After running the installation script:

$# Verify the binary exists
$ls /usr/local/bin/brev
$
$# Verify CLI is in PATH
$which brev
$
$# Verify CLI works
$brev --help

The brev --help command should display the CLI help output.

Rollback

To remove the installed CLI:

$sudo rm -f /usr/local/bin/brev

Why This Happens

The nested shell command sudo bash -c "$(curl ...)" can fail silently in certain shell configurations. Running the script directly provides better visibility into any errors that occur during installation.

Alternative Installation Methods

If the script installation continues to fail, you can install using Homebrew (if available on your system):

$brew install brevdev/homebrew-brev/brev

Or download the binary directly from the Brev CLI releases page.