#+TITLE: Homebrew Package Manager
#+author: User
#+created: [2026-03-16 Mon 14:28]
#+DATE: 2026-03-04
#+FILETAGS: :tools:package-manager:brew

* Homebrew
:PROPERTIES:
:ID: 20260304-homebrew
:CREATED: [2026-03-04 Tue]
:END:

** Installation

Homebrew installed locally in `~/.linuxbrew/` (Linux user-space installation).

```bash
# Clone Homebrew
git clone --depth=1 https://github.com/Homebrew/brew ~/.linuxbrew

# Add to shell
eval "$(~/.linuxbrew/bin/brew shellenv)"
```

** Configuration

Added shell integration:
- ~/.bashrc: `eval "$("$HOME"/linuxbrew/bin/brew shellenv)"`
- OpenClaw config: `shellEnvExtra` includes brew initialization

** Commands

| Command | Purpose |
|---------|---------|
| `brew install <formula>` | Install a package |
| `brew search <term>` | Search for packages |
| `brew list` | List installed packages |
| `brew update` | Update Homebrew itself |
| `brew upgrade` | Upgrade installed packages |

** Usage in OpenClaw

Skills can now declare Homebrew-based dependencies:

```yaml
metadata:
  openclaw:
    requires:
      bins: ["emacs", "jq", "ripgrep"]
    install:
      - id: homebrew
        kind: brew
        formula: emacs
        bins: ["emacs"]
```

** Notes

- No sudo required (user-space install)
- Formulas may build from source (slower than bottles)
- See https://formulae.brew.sh for available packages