Install Bruin

Get ready to build data pipelines with Bruin in about 2 minutes. Install the CLI, add the VS Code extension, and optionally connect an AI coding assistant via the Bruin MCP.

What

• Bruin CLI for running pipelines from the terminal
• VS Code extension for visual pipeline development
• Bruin MCP to connect AI tools (Claude Code, Cursor, Codex) to your pipelines

How

• One-line install commands for macOS, Linux, and Windows
• Extension available from the VS Code marketplace
• MCP setup is one command per AI tool

Install the Bruin CLI

Run this command in your terminal (macOS, Linux, or Windows via Git Bash/WSL):

curl -LsSf https://getbruin.com/install/cli | sh

Or with wget:

wget -qO- https://getbruin.com/install/cli | sh

Verify the installation:

bruin version

If you get a Permission Denied error, run with sudo:

curl -LsSf https://getbruin.com/install/cli | sudo sh

Install the VS Code extension

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "Bruin" in the Extensions search bar
   
4. Install the extension - click the Install button next to the Bruin extension in the results. You can also enable Auto Update to stay on the latest version.
   
   Once installed, the extension will also check whether the Bruin CLI is present. If it's missing, you'll see an Install Bruin CLI button in the Settings tab - one click installs the CLI directly from VS Code.

The extension gives you syntax highlighting, autocompletion, data lineage visualization, query preview, and a visual interface for running pipelines - all inside your editor. See the IDE Extension module for a full walkthrough of features.

Set up the Bruin MCP (optional)

The Bruin MCP lets AI coding tools query your data, build pipelines, and look up Bruin documentation directly. Pick the tool you use:

Claude Code:

claude mcp add bruin -- bruin mcp

Cursor: Go to Settings > MCP & Integrations > Add Custom MCP:

{
  "mcpServers": {
    "bruin": { "command": "bruin", "args": ["mcp"] }
  }
}

VS Code (Copilot): Add to your mcp.json:

{
  "servers": {
    "bruin": { "type": "stdio", "command": "bruin", "args": ["mcp"] }
  }
}

Codex CLI: Add to ~/.codex/config.toml:

[mcp_servers.bruin]
command = "bruin"
args = ["mcp"]

Restart your AI tool after adding the MCP. To verify, ask it: "What connections are available in this Bruin project?"