2018-10-02 08:10:03 +02:00
|
|
|
# brew plugin
|
|
|
|
|
|
|
|
|
|
The plugin adds several aliases for common [brew](https://brew.sh) commands.
|
|
|
|
|
|
|
|
|
|
To use it, add `brew` to the plugins array of your zshrc file:
|
2020-05-26 17:36:55 +02:00
|
|
|
|
|
|
|
|
```zsh
|
2018-10-02 08:10:03 +02:00
|
|
|
plugins=(... brew)
|
|
|
|
|
```
|
|
|
|
|
|
2022-07-12 18:40:39 +02:00
|
|
|
## Shellenv
|
|
|
|
|
|
2023-09-13 10:48:16 +02:00
|
|
|
If `brew` is not found in the PATH, this plugin will attempt to find it in common locations, and execute
|
|
|
|
|
`brew shellenv` to set the environment appropriately. This plugin will also export
|
|
|
|
|
`HOMEBREW_PREFIX="$(brew --prefix)"` if not previously defined for convenience.
|
|
|
|
|
|
|
|
|
|
In case you installed `brew` in a non-common location, you can still set `BREW_LOCATION` variable pointing to
|
|
|
|
|
the `brew` binary before sourcing `oh-my-zsh.sh` and it'll set up the environment.
|
2022-07-12 18:40:39 +02:00
|
|
|
|
2018-10-02 08:10:03 +02:00
|
|
|
## Aliases
|
|
|
|
|
|
2023-01-19 12:20:44 +01:00
|
|
|
| Alias | Command | Description |
|
|
|
|
|
| -------- | --------------------------------------- | ------------------------------------------------------------------- |
|
2020-05-04 15:46:27 +02:00
|
|
|
| `bc` | `brew cleanup` | Run cleanup. |
|
|
|
|
|
| `bci` | `brew info --cask` | Display information about the given cask. |
|
|
|
|
|
| `bcin` | `brew install --cask` | Install the given cask. |
|
|
|
|
|
| `bcl` | `brew list --cask` | List installed casks. |
|
|
|
|
|
| `bco` | `brew outdated --cask` | Report all outdated casks. |
|
|
|
|
|
| `bcrin` | `brew reinstall --cask` | Reinstall the given cask. |
|
|
|
|
|
| `bcubc` | `brew upgrade --cask && brew cleanup` | Upgrade outdated casks, then run cleanup. |
|
2023-01-19 12:20:44 +01:00
|
|
|
| `bcubo` | `brew update && brew outdated --cask` | Update Homebrew data, then list outdated casks. |
|
2020-05-04 15:46:27 +02:00
|
|
|
| `bcup` | `brew upgrade --cask` | Upgrade all outdated casks. |
|
|
|
|
|
| `bfu` | `brew upgrade --formula` | Upgrade only formulas (not casks). |
|
|
|
|
|
| `bl` | `brew list` | List all installed formulae. |
|
|
|
|
|
| `bo` | `brew outdated` | List installed formulae that have an updated version available. |
|
2023-01-19 12:20:44 +01:00
|
|
|
| `brewp` | `brew pin` | Pin a specified formula so that it's not upgraded. |
|
|
|
|
|
| `brews` | `brew list -1` | List installed formulae or the installed files for a given formula. |
|
|
|
|
|
| `brewsp` | `brew list --pinned` | List pinned formulae, or show the version of a given formula. |
|
2020-05-04 15:46:27 +02:00
|
|
|
| `bu` | `brew update` | Update brew and all installed formulae. |
|
2023-01-19 12:20:44 +01:00
|
|
|
| `bubc` | `brew upgrade && brew cleanup` | Upgrade outdated formulae and casks, then run cleanup. |
|
|
|
|
|
| `bubo` | `brew update && brew outdated` | Update Homebrew data, then list outdated formulae and casks. |
|
2019-12-29 17:53:50 +01:00
|
|
|
| `bubu` | `bubo && bup` | Do the last two operations above. |
|
2020-05-04 15:46:27 +02:00
|
|
|
| `bugbc` | `brew upgrade --greedy && brew cleanup` | Upgrade outdated formulae and casks (greedy), then run cleanup. |
|
|
|
|
|
| `bup` | `brew upgrade` | Upgrade outdated, unpinned brews. |
|
2023-01-19 12:20:44 +01:00
|
|
|
| `buz` | `brew uninstall --zap` | Remove all files associated with a cask. |
|
2023-01-09 20:02:44 +01:00
|
|
|
|
2020-05-26 17:36:55 +02:00
|
|
|
## Completion
|
|
|
|
|
|
2023-09-13 10:48:16 +02:00
|
|
|
This plugin configures paths with Homebrew's completion functions automatically, so you don't need to do it
|
|
|
|
|
manually. See: https://docs.brew.sh/Shell-Completion#configuring-completions-in-zsh.
|
2023-06-15 11:01:02 +02:00
|
|
|
|
2023-09-13 10:48:16 +02:00
|
|
|
With the release of Homebrew 1.0, they decided to bundle the zsh completion as part of the brew installation,
|
|
|
|
|
so we no longer ship it with the brew plugin; now it only has brew aliases. If you find that brew completion
|
|
|
|
|
no longer works, make sure you have your Homebrew installation fully up to date.
|
