Install the CLI
Install the Bruin CLI on macOS, Linux, or Windows and verify it's working.
What you'll do
Install the Bruin CLI on your machine and verify it's ready to use.
Why this step matters
The Bruin CLI is the core tool for creating projects, running pipelines, managing connections, and querying data. Everything else in Bruin builds on it.
Instructions
1) Install the CLI
Run this command in your terminal:
curl -LsSf https://getbruin.com/install/cli | sh
This works on macOS, Linux, and Windows (via Git Bash or WSL).
If you prefer wget:
wget -qO- https://getbruin.com/install/cli | sh
Note
Windows users: Make sure to run the command in Git Bash or WSL, not PowerShell or Command Prompt.
2) Fix permission issues (if needed)
If you see a Permission Denied error, your user doesn't have write access to ~/.local/bin. Run with sudo:
curl -LsSf https://getbruin.com/install/cli | sudo sh
3) Verify the installation
Check that Bruin is installed and accessible:
bruin version
You should see a version number printed. If you get command not found, make sure ~/.local/bin is in your PATH.
Note
Homebrew users: The Homebrew installation method is deprecated. If you previously installed Bruin via Homebrew, uninstall it first with brew uninstall bruin, then use the curl command above.
What just happened
You installed the Bruin CLI. It's now available in your terminal for creating projects, running pipelines, and managing connections. Next, you'll install the VS Code extension for a visual development experience.