Installing the InfraAudit CLI on macOS, Linux, Windows

The infraudit CLI is a single static Go binary with no runtime dependencies. You can build it from source or pull it directly with go install if you already have a Go toolchain.

Prerequisites

Go 1.24 or newer — download at go.dev
Git (required for the from-source method)

Installation

go install
Build from source

Pull and build the latest CLI in one step:

go install github.com/pratik-mahalle/infraudit/cmd/cli@latest

The binary lands in $GOPATH/bin/ (typically $HOME/go/bin/). Make sure that directory is in your PATH:

echo 'export PATH="$HOME/go/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

echo 'export PATH="$HOME/go/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Clone the repository and build the binary:

git clone https://github.com/pratik-mahalle/infraudit-go.git
cd infraudit-go
make build-cli

The binary lands at ./bin/infraudit. Move it somewhere on your PATH:

sudo mv ./bin/infraudit /usr/local/bin/

Verify the installation

Run the following command to confirm the binary is available:

infraudit --help

You should see the top-level command list. If you get command not found, the install directory is not in your PATH. Fix it using the instructions in the tab above that matches your installation method.

The version subcommand is available as infraudit version to print the exact build version once a server connection is configured.

First-time setup

Initialize the config file

Run the interactive setup wizard to set your server URL and default output format:

infraudit config init
# > Enter server URL: https://api.infraudit.dev
# > Default output format: table

Authenticate with your InfraAudit account:

infraudit auth login
# > Email: you@example.com
# > Password: ********
# > Logged in as you@example.com

Verify connectivity

Check that the CLI can reach the server:

infraudit status

Shell completion

Tab completion is available for bash, zsh, fish, and PowerShell. See Shell completion for setup instructions.

Uninstall

Remove the binary and config directory:

rm $(which infraudit)
rm -rf ~/.infraudit

​Prerequisites

​Installation

​Verify the installation

​First-time setup

​Shell completion

​Uninstall

Prerequisites

Installation

Verify the installation

First-time setup

Shell completion

Uninstall