> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brew.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install brew-cli with Homebrew, a prebuilt binary, or npm, then run your first command.

Pick whichever channel fits your machine. All three ship the same CLI.

## Homebrew (macOS and Linux)

```bash theme={null}
brew install getbrew/tap/brew-cli
```

A self-contained binary, no runtime required. Upgrade later with `brew upgrade brew-cli`.

## npm

```bash theme={null}
npm install -g @brew.new/cli
```

Requires Node 20 or newer. For one-off runs without installing anything, use `npx @brew.new/cli` (handy inside CI jobs and agent sandboxes that already have Node).

## Prebuilt Binaries

Every [GitHub release](https://github.com/GetBrew/brew-cli/releases) attaches standalone binaries for macOS (Apple Silicon and Intel), Linux (x64 and arm64), and Windows, plus a `checksums.txt` with SHA-256 hashes. Download, verify, `chmod +x`, and place it on your `PATH`.

## Verify the Install

```bash theme={null}
brew-cli --version
```

Then [authenticate](/api-reference/cli/authentication) and run your first command:

```bash theme={null}
brew-cli whoami
```

## Staying Current

New platform capabilities ship as new CLI releases. Upgrade through the channel you installed with, for example `brew upgrade brew-cli` or `npm update -g @brew.new/cli`. The full source lives at [github.com/GetBrew/brew-cli](https://github.com/GetBrew/brew-cli).

## Need Help?

Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:

<Tabs>
  <Tab title="Self-Service Tools">
    <CardGroup cols="2">
      <Card title="Search Documentation" icon="magnifying-glass" color="#c44925">
        Type in the "Ask any question" search bar at the top left to instantly find relevant documentation pages.
      </Card>

      <Card title="ChatGPT/Claude Integration" icon="robot" color="#c44925">
        Click "Open in ChatGPT" at the top right of any page to explore it further with ChatGPT or Claude.
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Talk to Our Team">
    <CardGroup cols="2">
      <Card title="Schedule a Call" icon="calendar" color="#c44925" href="https://calendar.google.com/calendar/u/0/appointments/schedules/AcZssZ1iYoRUG1J792XQpbuQLjSRRDupr7MwraFK-HQRCtTYdBmrQi8nZu2qXfzKQigb8gbKJK3KN3-R">
        Book time with our founders for personalized guidance on strategy, best practices, or complex implementation questions.
      </Card>

      <Card title="Call Us Directly" icon="phone" color="#c44925">
        Need immediate assistance? Reach us at **+1-(332)-203-2145** for urgent issues or time-sensitive questions.
      </Card>

      <Card title="Slack Channel" icon="slack" color="#c44925">
        Our preferred support channel. You'll receive an invite after signup for direct founder support and fast responses.
      </Card>

      <Card title="Email Support" icon="envelope" color="#c44925" href="mailto:support@brew.new">
        Contact us at **[support@brew.new](mailto:support@brew.new)** for detailed inquiries or if you prefer not to use Slack.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>