brew(1) — Недостающий пакетный менеджер для macOS (или Linux)

КРАТКОЕ ОПИСАНИЕ

brew --version
brew command [--verbose|-v] [options] [formula] …

ОПИСАНИЕ

Homebrew — самый простой и гибкий способ устанавливать инструменты UNIX, которые Apple не включила в macOS. Он также позволяет устанавливать программное обеспечение, не упакованное для вашего дистрибутива Linux, без необходимости в sudo.

ТЕРМИНОЛОГИЯ

формула: определение пакета Homebrew, который собирается из исходного кода вышестоящего проекта
cask: определение пакета Homebrew, устанавливающего предварительно скомпилированные двоичные файлы, собранные и подписанные вышестоящим проектом
префикс: путь, по которому установлен Homebrew, например /opt/homebrew или /home/linuxbrew/.linuxbrew
keg: каталог установки определённой версии формулы, например /opt/homebrew/Cellar/foo/0.1
rack: каталог, содержащий один или несколько версионированных keg, например /opt/homebrew/Cellar/foo
только в keg: формула считается доступной только в keg, если на неё не создана символическая ссылка в префиксе Homebrew
opt-префикс: символическая ссылка на активную версию keg, например /opt/homebrew/opt/foo
Cellar: каталог, содержащий один или несколько именованных rack, например /opt/homebrew/Cellar
Caskroom: каталог, содержащий один или несколько именованных cask, например /opt/homebrew/Caskroom
внешняя команда: подкоманда brew, определённая вне репозитория Homebrew/brew на GitHub
tap: каталог (обычно также репозиторий Git) с формулами, cask и/или внешними командами
бутылка: предварительно собранный keg, помещаемый в rack каталога Cellar вместо сборки из исходного кода вышестоящего проекта

ОСНОВНЫЕ КОМАНДЫ

Полный список команд см. в разделе КОМАНДЫ.

С параметрами --verbose или --debug многие команды выводят дополнительную отладочную информацию. Обратите внимание: эти параметры следует указывать только после команды.

Поведение некоторых команд можно настроить с помощью переменных среды; см. раздел СРЕДА.

`install` `formula`

Установить formula.

formula обычно представляет собой имя устанавливаемой формулы, но поддерживаются и другие синтаксические формы, перечисленные в разделе УКАЗАНИЕ ФОРМУЛ.

`uninstall` `formula`

Удалить formula.

`list`

Вывести список всех установленных формул.

`search` [`text`|`/``text``/`]

Выполнить поиск подстроки в токенах cask и именах формул по запросу text. Если запрос text заключён в косые черты, он трактуется как регулярное выражение. Поиск по запросу text расширяется на homebrew/core и homebrew/cask. Если поисковый запрос не указан, выводятся все формулы, доступные локально.

КОМАНДЫ

`alias` [`--edit`] [`alias`|`alias`=`command`]

Показать команду, соответствующую псевдониму. Если псевдоним не указан, вывести весь список.

--edit: Редактировать псевдонимы в текстовом редакторе. Можно открыть один или сразу все псевдонимы. Если указанный псевдоним не существует, для него будет создан шаблон.

`as-console-user` `command` [`args` …]

Выполнить команду Homebrew от имени активного пользователя консоли macOS.

Предназначено для рабочих процессов MDM, Munki и Jamf, в которых brew вызывается от имени root, но операции Homebrew должны выполняться от имени пользователя, вошедшего в систему через консоль. Вложенная команда всегда запускается через HOMEBREW_BREW_FILE.

`autoremove` [`--dry-run`]

Удалить формулы, установленные только как зависимости другой формулы и больше не нужные.

-n, --dry-run: Вывести список того, что было бы удалено, но ничего не удалять.

`bundle` [`subcommand`]

Менеджер зависимостей, не относящихся к Ruby: Homebrew, Homebrew Cask, Mac App Store, расширения VSCode (и форков/вариантов), пакеты Go, Cargo и npm, инструменты uv, пакеты Flatpak и WinGet, плагины Krew.

Примечание: поддержка Flatpak доступна только в Linux.

--file: Читать или записывать Brewfile по этому пути. Используйте --file=- для передачи данных через stdin/stdout.
-g, --global: Читать или записывать Brewfile из $HOMEBREW_BUNDLE_FILE_GLOBAL (если задано), ${XDG_CONFIG_HOME}/homebrew/Brewfile (если задано $XDG_CONFIG_HOME), либо из ~/.homebrew/Brewfile или ~/.Brewfile.
brew bundle sh [--check] [--no-secrets]: Запустить оболочку в среде brew bundle exec.
--install: Выполнить install перед запуском оболочки.
--services: Временно запускать службы во время работы оболочки. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_SERVICES.
--check: Перед запуском оболочки проверить, установлены ли все зависимости из Brewfile. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CHECK.
--no-secrets: Попытаться удалить секреты из среды перед запуском оболочки.
brew bundle remove name […]: Удалить из Brewfile записи, соответствующие name. Используйте --formula, --cask, --tap, --mas, --vscode, --go, --cargo, --uv, --flatpak, --winget, --krew и --npm, чтобы удалить только записи соответствующего типа. Передача --formula также удаляет совпадения с псевдонимами формул и их старыми именами.
--install: Выполнить install перед удалением записей.
--formula: Удалить записи формул Homebrew, включая совпадения с псевдонимами формул и старыми именами.
--cask: Удалить записи cask Homebrew.
--tap: Удалить записи tap Homebrew.
--mas: Удалить записи зависимостей Mac App Store.
--vscode: Удалить записи расширений VSCode (и форков/вариантов).
--go: Удалить записи пакетов Go.
--cargo: Удалить записи пакетов Cargo.
--uv: Удалить записи инструментов uv.
--flatpak: Удалить записи пакетов Flatpak. Примечание: только Linux.
--winget: Удалить записи пакетов WinGet. Примечание: только WSL.
--krew: Удалить записи плагинов Krew.
--npm: Удалить записи пакетов npm.
brew bundle list: Вывести список всех зависимостей, присутствующих в Brewfile.

По умолчанию выводятся только зависимости формул Homebrew.

--install: Выполнить install перед выводом списка зависимостей.
--all: Вывести список всех зависимостей.
--formula: Вывести список зависимостей формул Homebrew.
--cask: Вывести список зависимостей cask Homebrew.
--tap: Вывести список зависимостей tap Homebrew.
--mas: Вывести список зависимостей Mac App Store.
--vscode: Вывести список расширений VSCode (и форков/вариантов).
--go: Вывести список пакетов Go.
--cargo: Вывести список пакетов Cargo.
--uv: Вывести список инструментов uv.
--flatpak: Вывести список пакетов Flatpak. Примечание: только Linux.
--winget: Вывести список пакетов WinGet. Примечание: только WSL.
--krew: Вывести список плагинов Krew.
--npm: Вывести список пакетов npm.
brew bundle [install|upgrade]: Установить и (по умолчанию) обновить все зависимости из Brewfile.

Используйте эту команду, чтобы восстановить записанное состояние установки из Brewfile.

brew bundle upgrade — это сокращённая форма brew bundle install --upgrade.

Расположение Brewfile можно указать с помощью --file или задать переменную среды $HOMEBREW_BUNDLE_FILE.

Установку зависимостей можно пропустить, добавив значения, разделённые пробелами, в одну или несколько следующих переменных среды: $HOMEBREW_BUNDLE_BREW_SKIP, $HOMEBREW_BUNDLE_CASK_SKIP, $HOMEBREW_BUNDLE_MAS_SKIP, $HOMEBREW_BUNDLE_TAP_SKIP.

-v, --verbose: Выводить результат команд по мере их выполнения.
--no-upgrade: Не выполнять brew upgrade для устаревших зависимостей. Учтите, что при необходимости они всё ещё могут быть обновлены командой brew install. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_NO_UPGRADE.
--upgrade: Выполнять brew upgrade для устаревших зависимостей, даже если задано $HOMEBREW_BUNDLE_NO_UPGRADE.
--upgrade-formulae: Выполнить brew upgrade для любых указанных формул, разделённых запятыми, даже если задано $HOMEBREW_BUNDLE_NO_UPGRADE.
--jobs: Выполнять параллельно не более указанного количества установок формул. По умолчанию — 1 (последовательно). Используйте auto, чтобы задать количество ядер ЦП (максимум 4).
-f, --force: Запустить с --force/--overwrite.
--force-cleanup: Выполнить очистку после установки зависимостей без запроса подтверждения. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_FORCE_INSTALL_CLEANUP и передан параметр --global.
--zap: Использовать zap вместо uninstall при очистке cask после установки зависимостей.
brew bundle exec [--check] [--no-secrets] [--sandbox=path] [--deny-network] command: Выполнить внешнюю команду в изолированной среде сборки, основанной на зависимостях Brewfile.

Эта очищенная среда сборки игнорирует незапрошенные зависимости, благодаря чему команды вроде bundle install, npm install и т. д. не будут использовать то, что не указано в Brewfile. Кроме того, в неё добавляются флаги компилятора, помогающие находить зависимости, доступные только в keg, например openssl, icu4c и т. д.

--install: Выполнить install перед запуском команды.
--services: Временно запускать службы во время выполнения команды. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_SERVICES.
--check: Перед выполнением команды проверить, установлены ли все зависимости из Brewfile. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CHECK.
--no-secrets: Попытаться удалить секреты из среды перед выполнением команды.
--sandbox: Выполнить command в песочнице Homebrew, разрешив запись в path, а также во временные каталоги и каталоги кэша Homebrew.
--deny-network: Запретить сетевой доступ из песочницы.
brew bundle env [--check] [--no-secrets]: Вывести переменные среды, которые были бы установлены в среде brew bundle exec.
--install: Выполнить install перед выводом среды.
--check: Перед выводом среды проверить, установлены ли все зависимости из Brewfile. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CHECK.
--no-secrets: Попытаться удалить секреты из среды перед её выводом.
brew bundle edit: Редактировать Brewfile в редакторе.
--install: Выполнить install перед редактированием Brewfile.
brew bundle dump: Записать все установленные cask/формулы/образы/tap в Brewfile в текущем каталоге или в пользовательский файл, указанный параметром --file. Это удобно для создания снимка состояния установки, который можно хранить в системе контроля версий и сравнивать.
--install: Выполнить install перед выгрузкой зависимостей.
-f, --force: Перезаписать существующий Brewfile.
--formula: Выгрузить зависимости формул Homebrew.
--no-formula: Выгрузить без зависимостей формул Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_BREW.
--no-dump-brew: Выгрузить без зависимостей формул Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_BREW.
--cask: Выгрузить зависимости cask Homebrew.
--no-cask: Выгрузить без зависимостей cask Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_CASK.
--no-dump-cask: Выгрузить без зависимостей cask Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_CASK.
--tap: Выгрузить зависимости tap Homebrew.
--no-tap: Выгрузить без зависимостей tap Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_TAP.
--no-dump-tap: Выгрузить без зависимостей tap Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_TAP.
--mas: Выгрузить зависимости Mac App Store.
--vscode: Выгрузить расширения VSCode (и форков/вариантов).
--go: Выгрузить пакеты Go.
--cargo: Выгрузить пакеты Cargo.
--uv: Выгрузить инструменты uv.
--flatpak: Выгрузить пакеты Flatpak. Примечание: только Linux.
--winget: Выгрузить пакеты WinGet. Примечание: только WSL.
--krew: Выгрузить плагины Krew.
--npm: Выгрузить пакеты npm.
--no-mas: dump без зависимостей Mac App Store. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_MAS.
--no-dump-mas: dump без зависимостей Mac App Store. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_MAS.
--no-vscode: dump без расширений VSCode (и форков/вариантов). Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_VSCODE.
--no-dump-vscode: dump без расширений VSCode (и форков/вариантов). Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_VSCODE.
--no-go: dump без пакетов Go. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_GO.
--no-dump-go: dump без пакетов Go. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_GO.
--no-cargo: dump без пакетов Cargo. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_CARGO.
--no-dump-cargo: dump без пакетов Cargo. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_CARGO.
--no-uv: dump без инструментов uv. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_UV.
--no-dump-uv: dump без инструментов uv. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_UV.
--no-flatpak: dump без пакетов Flatpak. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_FLATPAK.
--no-dump-flatpak: dump без пакетов Flatpak. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_FLATPAK.
--no-winget: dump без пакетов WinGet. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_WINGET.
--no-dump-winget: dump без пакетов WinGet. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_WINGET.
--no-krew: dump без плагинов Krew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_KREW.
--no-dump-krew: dump без плагинов Krew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_KREW.
--no-npm: dump без пакетов npm. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_NPM.
--no-dump-npm: dump без пакетов npm. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_DUMP_NO_NPM.
--no-describe: Не добавлять комментарии с описанием над каждой строкой. По умолчанию такие комментарии добавляются. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_NO_DESCRIBE.
--no-restart: Не добавлять restart_service в строки формул.
brew bundle cleanup: Удалить все зависимости, отсутствующие в Brewfile.

Этот рабочий процесс полезен для сопровождающих и тестировщиков, которым часто приходится устанавливать множество формул.

Если не передан параметр --force, команда возвращает код завершения 1, если какие-либо зависимости подлежали бы удалению.

--install: Выполнить install перед очисткой зависимостей.
-f, --force: Фактически выполнить операции очистки.
--all: Очистить все поддерживаемые зависимости.
--formula: Очистить зависимости формул Homebrew.
--no-formula: Очистить без зависимостей формул Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_BREW.
--no-cleanup-brew: Очистить без зависимостей формул Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_BREW.
--cask: Очистить зависимости cask Homebrew.
--no-cask: Очистить без зависимостей cask Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_CASK.
--no-cleanup-cask: Очистить без зависимостей cask Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_CASK.
--tap: Очистить зависимости tap Homebrew.
--no-tap: Очистить без зависимостей tap Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_TAP.
--no-cleanup-tap: Очистить без зависимостей tap Homebrew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_TAP.
--mas: Очистить зависимости Mac App Store.
--no-mas: cleanup без зависимостей Mac App Store. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_MAS.
--no-cleanup-mas: cleanup без зависимостей Mac App Store. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_MAS.
--vscode: Очистить расширения VSCode (и форков/вариантов).
--no-vscode: cleanup без расширений VSCode (и форков/вариантов). Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_VSCODE.
--no-cleanup-vscode: cleanup без расширений VSCode (и форков/вариантов). Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_VSCODE.
--go: Очистить пакеты Go.
--no-go: cleanup без пакетов Go. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_GO.
--no-cleanup-go: cleanup без пакетов Go. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_GO.
--cargo: Очистить пакеты Cargo.
--no-cargo: cleanup без пакетов Cargo. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_CARGO.
--no-cleanup-cargo: cleanup без пакетов Cargo. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_CARGO.
--uv: Очистить инструменты uv.
--no-uv: cleanup без инструментов uv. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_UV.
--no-cleanup-uv: cleanup без инструментов uv. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_UV.
--flatpak: Очистить пакеты Flatpak. Примечание: только Linux.
--no-flatpak: cleanup без пакетов Flatpak. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_FLATPAK.
--no-cleanup-flatpak: cleanup без пакетов Flatpak. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_FLATPAK.
--winget: Очистить пакеты WinGet. Примечание: только WSL.
--no-winget: cleanup без пакетов WinGet. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_WINGET.
--no-cleanup-winget: cleanup без пакетов WinGet. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_WINGET.
--krew: Очистить плагины Krew.
--no-krew: cleanup без плагинов Krew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_KREW.
--no-cleanup-krew: cleanup без плагинов Krew. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_KREW.
--npm: Очистить пакеты npm.
--no-npm: cleanup без пакетов npm. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_NPM.
--no-cleanup-npm: cleanup без пакетов npm. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_CLEANUP_NO_NPM.
--zap: Очищать cask с помощью команды zap вместо uninstall.
brew bundle check: Проверить, установлены ли все зависимости, присутствующие в Brewfile.

Если всё обновлено, команда завершается успешно, что делает её удобной для использования в сценариях. Используйте --verbose, чтобы вывести список неудовлетворённых зависимостей.

-v, --verbose: Вывести список всех отсутствующих зависимостей.
--no-upgrade: Не проверять наличие устаревших зависимостей. Учтите, что при необходимости они всё ещё могут быть обновлены командой brew install. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_NO_UPGRADE.
--install: Выполнить install перед проверкой зависимостей.
brew bundle add name […]: Добавить записи в Brewfile. По умолчанию добавляются формулы. Используйте --cask, --tap, --vscode, --go, --cargo, --uv, --flatpak, --krew и --npm, чтобы добавить запись соответствующего типа.
--install: Выполнить install перед добавлением записей.
--formula: Добавить записи формул Homebrew.
--cask: Добавить записи cask Homebrew.
--tap: Добавить записи tap Homebrew.
--vscode: Добавить записи расширений VSCode (и форков/вариантов).
--go: Добавить записи пакетов Go.
--cargo: Добавить записи пакетов Cargo.
--uv: Добавить записи инструментов uv.
--flatpak: Добавить записи пакетов Flatpak. Примечание: только Linux.
--krew: Добавить записи плагинов Krew.
--npm: Добавить записи пакетов npm.
--no-describe: Не добавлять комментарии с описанием над каждой строкой. По умолчанию такие комментарии добавляются. Включено по умолчанию, если задано $HOMEBREW_BUNDLE_NO_DESCRIBE.

`casks`

Вывести список всех доступных для локальной установки cask, включая короткие имена.

`cleanup` [`options`] [`formula`|`cask` …]

Удалить устаревшие файлы блокировки и загруженные файлы для всех формул и cask, а также старые версии установленных формул. Если указаны аргументы, выполнить очистку только для заданных формул и cask. Удаляются все загруженные файлы старше 120 дней. Этот срок можно изменить с помощью $HOMEBREW_CLEANUP_MAX_AGE_DAYS.

--prune: Удалить все файлы кэша старше указанного срока days. Чтобы удалить всё, используйте --prune=all.
-n, --dry-run: Показать, что будет удалено, но ничего не удалять.
-s, --scrub: Полностью очистить кэш, включая загруженные файлы даже для последних версий. Обратите внимание: загруженные файлы для установленных формул или cask всё равно не удаляются. Чтобы удалить и их: rm -rf "$(brew --cache)"
--prune-prefix: Удалить только символические ссылки и каталоги из префикса, не удаляя другие файлы.

`command` `command` […]

Показать путь к файлу, используемому при вызове brew cmd.

`command-not-found-init`

Вывести инструкции по настройке перехватчика command-not-found для вашей оболочки. Если вывод направлен не в терминал, вывести соответствующий скрипт-обработчик для вашей оболочки.

Дополнительная информация: https://docs.brew.sh/Command-Not-Found

`commands` [`--quiet`] [`--include-aliases`]

Показать списки встроенных и внешних команд.

-q, --quiet: Вывести только имена команд без заголовков категорий.
--include-aliases: Включить псевдонимы внутренних команд.

`completions` [`subcommand`]

Управлять автоматическим подключением Homebrew файлов автодополнения оболочки из внешних tap. Подробнее: https://docs.brew.sh/Shell-Completion.

brew completions unlink: Отвязать дополнения автозаполнения Homebrew.
brew completions [state]: Показать текущее состояние дополнений автозаполнения Homebrew.
brew completions link: Подключить дополнения автозаполнения Homebrew.

`config`, `--config`

Показать сведения о конфигурации Homebrew и системы, полезные для отладки. Если вы отправите отчёт об ошибке, вам потребуется предоставить эти сведения.

`deps` [`options`] [`formula`|`cask` …]

Показать зависимости для formula. Если указано несколько аргументов-формул, показать пересечение их зависимостей. По умолчанию deps показывает все обязательные и рекомендуемые зависимости.

Если установлена любая версия каждой указанной формулы и не переданы другие параметры, эта команда покажет фактические зависимости времени выполнения (как и brew linkage), которые могут отличаться от объявленных зависимостей формулы.

Примечание: --missing и --skip-recommended имеют приоритет над --include-*.

-n, --topological: Сортировать зависимости в топологическом порядке.
-1, --direct: Показать только прямые зависимости, объявленные в формуле.
--union: Показать объединение зависимостей нескольких formula вместо их пересечения.
--full-name: Вывести зависимости, используя их полные имена.
--include-implicit: Включить неявные зависимости, используемые для загрузки и распаковки исходных файлов.
--include-build: Включить зависимости :build для formula.
--include-optional: Включить зависимости :optional для formula.
--include-test: Включить зависимости :test для formula (без рекурсивного обхода, если не указано --graph или --tree).
--skip-recommended: Пропустить зависимости :recommended для formula.
--include-requirements: Включить требования в дополнение к зависимостям для formula.
--tree: Показать зависимости в виде дерева. Если указано несколько аргументов-формул, показать отдельное дерево для каждой формулы.
--prune: Исключить из дерева уже просмотренные ветви.
--graph: Показать зависимости в виде ориентированного графа.
--dot: Показать текстовое описание графа в формате DOT.
--annotate: Отмечать в выводе зависимости для сборки, тестирования, неявные, необязательные и рекомендуемые зависимости.
--installed: Вывести зависимости установленных формул. Если указано formula, вывести только те его зависимости, которые установлены.
--missing: Показать только отсутствующие зависимости.
--for-each: Перейти в режим, используемый при оценке всех формул и cask-пакетов, но вывести зависимости только для каждого указанного formula, по одной формуле в строке.
--HEAD: Показать зависимости для версии HEAD вместо стабильной версии.
--os: Показать зависимости для указанной операционной системы.
--arch: Показать зависимости для указанной архитектуры процессора.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`desc` [`options`] `formula`|`cask`|`text`|`/``regex``/` […]

Показать имя и краткое описание formula. Кэш создаётся при первом поиске, поэтому он занимает больше времени, чем последующие поиски.

-s, --search: Искать text в именах и описаниях. Если text заключён в косые черты, он интерпретируется как регулярное выражение.
-n, --name: Искать text только в именах. Если text заключён в косые черты, он интерпретируется как регулярное выражение.
-d, --description: Искать text только в описаниях. Если text заключён в косые черты, он интерпретируется как регулярное выражение.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`developer` [`subcommand`]

Управлять режимом разработчика Homebrew. Когда режим разработчика включён, brew update обновит Homebrew до последнего коммита в ветке main вместо последней стабильной версии; также будут внесены некоторые другие изменения в поведение.

brew developer [state]: Показать текущее состояние режима разработчика Homebrew.
brew developer on: Включить режим разработчика Homebrew.
brew developer off: Выключить режим разработчика Homebrew.

`docs`

Открыть онлайн-документацию Homebrew по адресу https://docs.brew.sh в браузере.

`doctor`, `dr` [`--list-checks`] [`--audit-debug`] [`diagnostic_check` …]

Проверить систему на наличие потенциальных проблем. Если такие проблемы будут обнаружены, команда завершится с ненулевым кодом состояния.

Обратите внимание: эти предупреждения предназначены лишь для помощи сопровождающим Homebrew в отладке, если вы сообщите о проблеме. Если всё, для чего вы используете Homebrew, работает нормально, не беспокойтесь и не отправляйте сообщение о проблеме — просто проигнорируйте это.

--list-checks: Вывести все методы аудита, которые можно запускать по отдельности, указав их в качестве аргументов.
-D, --audit-debug: Включить отладку и профилирование методов аудита.

`exec`, `x` [`--formulae=``formulae`] [`--sandbox=``path`] [`--deny-network`] [`--`] `command` [`args` …]

Запустить command в окружении, подготовленном с помощью формул Homebrew.

Если передан параметр --formulae, Homebrew при необходимости устанавливает указанные через запятую формулы, добавляет каталоги с их исполняемыми файлами и исполняемыми файлами их зависимостей в начало PATH и запускает command. Это позволяет передать в command путь к скрипту, например ./script.sh.

Если --formulae не указан, Homebrew находит формулу, предоставляющую command, при необходимости устанавливает её и запускает этот исполняемый файл.

Пример: brew exec --formulae=jq,yq -- ./script.sh

В системах с env -S в скриптах также можно использовать шебанг: #!/usr/bin/env -S brew exec --formulae=jq,yq --

--formulae: Формулы, которые нужно установить и добавить в PATH перед запуском command; указываются через запятую.
--sandbox: Запустить command в песочнице Homebrew, разрешив запись в path, а также во временные каталоги и каталоги кэша Homebrew.
--deny-network: Запретить сетевой доступ из песочницы.

`fetch` [`options`] `formula`|`cask` […]

Загрузить bottle (если доступен) или исходные пакеты для formulae и двоичные файлы для casks. Для файлов также вывести контрольные суммы SHA-256.

--os: Загрузить для указанной операционной системы. (Передайте all, чтобы загрузить для всех операционных систем.)
--arch: Загрузить для указанной архитектуры процессора. (Передайте all, чтобы загрузить для всех архитектур.)
--all-platforms: Загрузить для всех поддерживаемых операционных систем и архитектур, а также для каждого языка для casks; каждый уникальный URL загружается один раз.
--bottle-tag: Загрузить bottle для указанного тега.
--HEAD: Загрузить версию HEAD вместо стабильной версии.
-f, --force: Удалить ранее кэшированную версию и загрузить её заново.
-v, --verbose: Выполнить подробную выгрузку из системы контроля версий, если URL указывает на неё. Это полезно, чтобы проверить, обновился ли существующий кэш системы контроля версий.
--retry: Повторить попытку при сбое загрузки или загрузить файл заново, если контрольная сумма ранее кэшированной версии больше не совпадает. Выполняется не более 5 попыток с экспоненциально увеличивающимися интервалами.
--deps: Также загрузить зависимости для всех указанных formula.
-s, --build-from-source: Загрузить исходные пакеты вместо bottle.
--build-bottle: Загрузить исходные пакеты (для последующего создания bottle) вместо bottle.
--force-bottle: Загрузить bottle, если он доступен для текущей или новейшей версии macOS, даже если он не будет использоваться при установке.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`formulae`

Вывести все локально устанавливаемые формулы, включая короткие имена.

`gist-logs` [`--new-issue`] [`--private`] `formula`

Загрузить в новый Gist журналы неудачной сборки formula. Если журналы не найдены, вывести сообщение об ошибке.

-n, --new-issue: Автоматически создать задачу в соответствующем репозитории GitHub после создания Gist.
-p, --private: Gist будет помечен как закрытый и не будет отображаться в списках, но останется доступен по ссылке.

`help` [`command` …]

Вывести инструкции по использованию для brew command. Эквивалентно brew --help command.

`home`, `homepage` [`--formula`] [`--cask`] [`formula`|`cask` …]

Открыть в браузере домашнюю страницу formula или cask либо открыть домашнюю страницу самого Homebrew, если аргумент не указан.

--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`info`, `abv` [`options`] [`formula`|`cask` …]

Показать краткую статистику установки Homebrew. Если указана formula или cask, показать сводку сведений о ней.

--analytics: Вывести глобальные аналитические данные Homebrew или, если указан параметр, данные об установках и ошибках сборки для formula (если не заданы ни $HOMEBREW_NO_ANALYTICS, ни $HOMEBREW_NO_GITHUB_API).
--days: Количество дней аналитических данных для получения. Значение days должно быть равно 30, 90 или 365. По умолчанию используется 30.
--category: Тип аналитических данных для получения. Значение category должно быть install, install-on-request или build-error; можно указать cask-install или os-version, если не задан параметр formula. По умолчанию используется install.
--github: Открыть в браузере страницу исходного кода formula и cask на GitHub. Чтобы посмотреть историю локально: brew log -p formula или cask
--json: Вывести представление в формате JSON. Сейчас значение по умолчанию для version — v1 для formula. Для formula и cask используйте v2. Примеры использования вывода JSON см. в документации: https://docs.brew.sh/Querying-Brew
--installed: Вывести понятный человеку список установленных формул и cask-пакетов. Если передан параметр --json, вывести JSON для установленных формул, а с параметром --json=v2 — для установленных cask-пакетов.
--variations: Включить хеш вариаций в вывод JSON для каждой формулы.
-v, --verbose: Показать более подробные сведения о formula или полную информацию с параметром --installed.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.
--sizes: Показать размер установленных формул и cask-пакетов.

`install` [`options`] `formula`|`cask` […]

Установить formula или cask. К команде можно добавить дополнительные параметры, относящиеся к formula.

Если не задан параметр $HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK, для устаревших зависимых пакетов и пакетов с нарушенными связями будут соответственно запущены brew upgrade или brew reinstall.

Если не задан параметр $HOMEBREW_NO_INSTALL_CLEANUP, после этого для установленных формул будет запущен brew cleanup, а для всех формул — раз в 30 дней.

Если не задан параметр $HOMEBREW_NO_INSTALL_UPGRADE, команда brew install formula обновит formula, если он уже установлен, но устарел.

-d, --debug: Если сборка завершится с ошибкой, открыть интерактивный сеанс отладки с доступом к IRB или оболочке во временном каталоге сборки.
--display-times: В конце выполнения вывести время установки каждого пакета. Включено по умолчанию, если задан параметр $HOMEBREW_DISPLAY_INSTALL_TIMES.
-f, --force: Установить формулы, не проверяя наличие ранее установленных версий, предназначенных только для keg, или версий, которые ещё не были перенесены. При установке cask-пакетов перезаписать существующие файлы (кроме двоичных файлов и символических ссылок, если только они изначально не принадлежали тому же cask-пакету).
-v, --verbose: Вывести этапы проверки и завершающие действия после установки.
-n, --dry-run: Показать, что будет установлено, но ничего не устанавливать.
-y, --no-ask: Не запрашивать подтверждение перед загрузкой и установкой. По умолчанию включён режим запроса подтверждения. Включено по умолчанию, если задан параметр $HOMEBREW_NO_ASK.
--formula: Считать все именованные аргументы формулами.
--ignore-dependencies: Неподдерживаемый параметр разработки Homebrew, отключающий установку любых зависимостей. Если зависимости ещё не установлены, формула будет работать неправильно. Если вы не разрабатываете Homebrew, вместо этого параметра попробуйте скорректировать PATH.
--only-dependencies: Установить зависимости с указанными параметрами, но не устанавливать саму формулу.
--cc: Попытаться выполнить компиляцию с помощью указанного compiler, которым должно быть имя исполняемого файла компилятора, например gcc-9 для GCC 9. Чтобы использовать clang из LLVM, укажите llvm_clang. Чтобы использовать clang, предоставляемый Apple, укажите clang. Этот параметр принимает только компиляторы, предоставляемые Homebrew или входящие в состав macOS. Пожалуйста, не отправляйте сообщения о проблемах, если при использовании этого параметра возникнут ошибки.
-s, --build-from-source: Собрать formula из исходного кода, даже если доступен bottle. Если bottle доступны, зависимости всё равно будут установлены из bottle.
--force-bottle: Установить из bottle, если он доступен для текущей или новейшей версии macOS, даже если обычно он не использовался бы при установке.
--include-test: Установить тестовые зависимости, необходимые для запуска brew test formula.
--HEAD: Если в formula определена версия HEAD, установить её, то есть основную, магистральную, нестабильную или master-версию.
--fetch-HEAD: Получить данные из вышестоящего репозитория, чтобы определить, устарела ли установка HEAD формулы. В противном случае проверка обновлений HEAD репозитория будет выполняться только после выпуска новой стабильной версии или версии для разработчиков.
--keep-tmp: Сохранить временные файлы, созданные во время установки.
--debug-symbols: Создать отладочные символы при сборке. Исходный код будет сохранён в каталоге кэша.
--build-bottle: Подготовить формулу к последующему созданию bottle во время установки, пропустив все завершающие действия.
--skip-post-install: Установить, но пропустить все завершающие действия.
--skip-link: Установить, но не подключать keg к префиксу.
--as-dependency: Установить, но отметить пакет как установленный в качестве зависимости, а не по запросу пользователя.
--bottle-arch: Оптимизировать bottle для указанной архитектуры, а не для самой старой архитектуры, поддерживаемой версией macOS, в которой собираются bottle.
-i, --interactive: Загрузить и применить исправления к formula, затем открыть оболочку. Это позволяет пользователю запустить ./configure --help и другими способами определить, как превратить программный пакет в пакет Homebrew.
-g, --git: Создать репозиторий Git, полезный для подготовки исправлений программного обеспечения.
--overwrite: Удалить файлы, уже существующие в префиксе, во время создания ссылок.
--cask: Считать все именованные аргументы cask-пакетами.
--[no-]binaries: Отключить или включить создание ссылок на вспомогательные исполняемые файлы (по умолчанию включено).
--require-sha: Требовать наличия контрольной суммы у всех cask-пакетов.
--adopt: Принять существующие в целевом каталоге артефакты, идентичные устанавливаемым. Нельзя использовать вместе с --force.
--skip-cask-deps: Пропустить установку зависимостей cask-пакетов.
--zap: Используется вместе с brew reinstall --cask. Удалить все файлы, связанные с cask-пакетом. Может удалить файлы, общие для нескольких приложений.

`leaves` [`--installed-on-request`] [`--installed-as-dependency`]

Вывести установленные формулы, от которых не зависят другие установленные формулы или cask-пакеты.

-r, --installed-on-request: Вывести только пакеты, установленные вручную.
-p, --installed-as-dependency: Вывести только пакеты, установленные как зависимости.

`link`, `ln` [`options`] `installed_formula` […]

Создать символические ссылки на все установленные файлы formula в префиксе Homebrew. Это происходит автоматически при установке формул, но может пригодиться при ручной установке.

--overwrite: Удалить файлы, уже существующие в префиксе, во время создания ссылок.
-n, --dry-run: Вывести файлы, на которые команда brew link --overwrite создала бы ссылки или которые удалила бы, не создавая ссылок и не удаляя файлы.
-f, --force: Разрешить создание ссылок на формулы, предназначенные только для keg.
--HEAD: Создать ссылку на версию HEAD формулы, если она установлена.

`list`, `ls` [`options`] [`installed_formula`|`installed_cask` …]

Вывести все установленные формулы и cask-пакеты. Если указан formula, вывести сводку путей в его текущем keg. Если указан cask, вывести его артефакты.

--formula: Вывести только формулы или считать все именованные аргументы формулами.
--cask: Вывести только cask-пакеты или считать все именованные аргументы cask-пакетами.
--full-name: Вывести формулы с полными именами. Если не переданы --full-name, --versions или --pinned, остальные параметры (то есть -1, -l, -r и -t) передаются в ls(1), которая формирует фактический вывод.
--versions: Показать номера версий установленных формул или только указанных формул, если переданы аргументы formula.
--json: Вывести установленные формулы и cask-пакеты, их версии, связанные и дополнительно связанные версии формул и закреплённые версии в формате JSON, используя быстрый путь выполнения команды Bash. Требуются --versions, отсутствие именованных аргументов и jq.
--multiple: Показать только формулы с несколькими установленными версиями. Подразумевает --versions.
--pinned: Вывести только закреплённые пакеты или только указанные закреплённые пакеты, если переданы formula или cask. См. также pin, unpin.
--installed-on-request: Вывести формулы, установленные по запросу пользователя.
--no-installed-on-request: Вывести формулы, установленные не по запросу пользователя (то есть как зависимости).
--poured-from-bottle: Вывести формулы, установленные из bottle.
--built-from-source: Вывести формулы, собранные из исходного кода.
-1: Принудительно выводить по одной записи в строке. Используется по умолчанию, если вывод направлен не в терминал.
-l: Вывести формулы и/или cask-пакеты в подробном формате. Не действует, если в качестве аргумента передано имя формулы или cask-пакета.
-r: Изменить порядок сортировки формул и/или cask-пакетов на обратный, чтобы сначала выводить самые старые записи. Не действует, если в качестве аргумента передано имя формулы или cask-пакета.
-t: Сортировать формулы и/или cask-пакеты по времени изменения, выводя сначала недавно изменённые. Не действует, если в качестве аргумента передано имя формулы или cask-пакета.

`log` [`options`] [`formula`|`cask`]

Показать git log для formula или cask либо показать журнал репозитория Homebrew, если формула или cask-пакет не указаны.

-p, --patch: Также вывести патч из коммита.
--stat: Также вывести статистику изменений коммита.
--oneline: Выводить по одной строке на коммит.
-1: Вывести только один коммит.
-n, --max-count: Вывести только указанное количество коммитов.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`mcp-server` [`--debug`]

Запустить сервер Homebrew MCP (протокол контекста модели).

-d, --debug: Включить запись отладочных сообщений в stderr.

`migrate` [`options`] `installed_formula`|`installed_cask` […]

Перенести переименованные пакеты под новыми именами; formula — старые имена пакетов.

-f, --force: Считать установленные formula и указанные formula принадлежащими одним и тем же tap-репозиториям и всё равно перенести их.
-n, --dry-run: Показать, что будет перенесено, но ничего не переносить.
--formula: Переносить только формулы.
--cask: Переносить только cask-пакеты.

`missing` [`--hide=`] [`formula`|`cask` …]

Проверить указанные keg-пакеты formula и установки cask на отсутствующие зависимости. Если formula и cask не указаны, проверить все keg-пакеты и cask-пакеты. Команда завершится с ненулевым кодом состояния, если обнаружит пакеты без необходимых зависимостей.

--hide: Считать, что ни один из указанных hidden не установлен. hidden должен представлять собой список формул или cask-пакетов, разделённых запятыми.

`nodenv-sync`

Создать символические ссылки на установленные версии NodeJS из Homebrew в каталоге ~/.nodenv/versions.

Обратите внимание: будут также созданы ссылки на предыдущие версии. Например, NodeJS 19.1.0 будет также связан с версией 19.0.0.

`options` [`--compact`] [`--installed`] [`formula` …]

Показать параметры установки, относящиеся к formula.

--compact: Показать все параметры в одной строке, разделив их пробелами.
--installed: Показать параметры для установленных формул.

`outdated` [`options`] [`formula`|`cask` …]

Вывести установленные cask-пакеты и формулы, для которых доступна обновлённая версия. По умолчанию сведения о версиях отображаются в интерактивных оболочках и скрываются в остальных случаях.

-q, --quiet: Выводить только названия устаревших keg-пакетов (имеет приоритет над --verbose).
-v, --verbose: Включить подробную информацию о версиях.
--formula: Выводить только устаревшие формулы.
--cask: Выводить только устаревшие cask-пакеты.
--json: Выводить данные в формате JSON. Существует два варианта: v1 и v2. v1 устарел и используется по умолчанию, если версия не указана. v2 выводит устаревшие формулы и cask-пакеты.
--minimum-version: Выводить только указанную формулу или cask-пакет, установленная версия которой ниже заданной минимальной версии.
--fetch-HEAD: Получить данные из upstream-репозитория, чтобы определить, устарела ли HEAD-установка формулы. В противном случае обновления HEAD-версии репозитория будут проверяться только после выпуска новой стабильной или разрабатываемой версии.
-g, --greedy: Также включать устаревшие cask-пакеты с version :latest и auto_updates true cask-пакеты, которые иначе были бы пропущены. Включено по умолчанию, если задано $HOMEBREW_UPGRADE_GREEDY.
--greedy-latest: Также включать устаревшие cask-пакеты, в том числе с version :latest.
--greedy-auto-updates: Также включать устаревшие auto_updates true cask-пакеты, которые иначе были бы пропущены.

`pin` [`--formula`] [`--cask`] `installed_formula`|`installed_cask` […]

Закрепить указанный пакет, чтобы предотвратить его обновление при выполнении команды brew upgrade formula или cask. См. также unpin.

Примечание: Другие пакеты, которым требуются более новые версии закреплённой формулы, могут не установиться или работать некорректно. Закреплённые cask-пакеты с auto_updates true могут обновляться самостоятельно, вне Homebrew.

--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`postinstall`, `post_install` `installed_formula` […]

Повторно выполнить действия после установки для formula.

`pyenv-sync`

Создать символические ссылки на установленные Homebrew версии Python в ~/.pyenv/versions.

Обратите внимание: также будут созданы символические ссылки для более старых версий исправлений, указывающие на минорную версию; например, Python 3.11.0 также будет связан с 3.11.3.

`rbenv-sync`

Создать символические ссылки на установленные Homebrew версии Ruby в ~/.rbenv/versions.

Обратите внимание: также будут созданы символические ссылки для более старых версий; например, Ruby 3.2.1 также будет связан с 3.2.0.

`readall` [`options`] [`tap` …]

Импортировать все элементы из указанного tap или из всех установленных taps, если он не указан. Это может быть полезно для отладки проблем со всеми элементами при внесении значительных изменений в formula.rb, проверки производительности загрузки всех элементов или поиска проблем Ruby в существующих формулах/cask-пакетах.

--os: Выполнить чтение с использованием указанной операционной системы. (Передайте all, чтобы смоделировать все операционные системы.)
--arch: Выполнить чтение с использованием указанной архитектуры ЦП. (Передайте all, чтобы смоделировать все архитектуры.)
--aliases: Проверить символические ссылки псевдонимов в каждом tap.
--syntax: Проверить синтаксис всех Ruby-файлов Homebrew (если не передан tap).
--no-simulate: Не имитировать другие конфигурации системы при проверке формул и cask-пакетов.

`reinstall` [`options`] `formula`|`cask` […]

Удалить, а затем повторно установить formula или cask, используя те же параметры, с которыми он был установлен изначально, а также дополнительные параметры, относящиеся к formula.

Если не задано $HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK, для устаревших зависимых пакетов и зависимых пакетов с нарушенными связями будут запущены соответственно brew upgrade или brew reinstall.

Если не задано $HOMEBREW_NO_INSTALL_CLEANUP, для переустановленных формул будет выполнено brew cleanup, а для всех формул — раз в 30 дней.

-d, --debug: Если сборка не удалась, открыть интерактивный сеанс отладки с доступом к IRB или оболочке во временном каталоге сборки.
--display-times: В конце выполнения выводить время установки для каждого пакета. Включено по умолчанию, если задано $HOMEBREW_DISPLAY_INSTALL_TIMES.
-f, --force: Установить без проверки ранее установленных версий, предназначенных только для keg, или версий, не прошедших миграцию.
-v, --verbose: Выводить этапы проверки и действия после установки.
-y, --no-ask: Не запрашивать подтверждение перед загрузкой и переустановкой. По умолчанию используется режим запроса подтверждения. Включено по умолчанию, если задано $HOMEBREW_NO_ASK.
--formula: Считать все именованные аргументы формулами.
-s, --build-from-source: Собрать formula из исходного кода, даже если доступен bottle.
-i, --interactive: Загрузить и применить исправления к formula, затем открыть оболочку. Это позволяет пользователю выполнить ./configure --help и другими способами определить, как превратить программный пакет в пакет Homebrew.
--force-bottle: Установить из bottle, если он существует для текущей или новейшей версии macOS, даже если обычно он не использовался бы для установки.
--keep-tmp: Сохранить временные файлы, созданные во время установки.
--debug-symbols: Создать отладочные символы во время сборки. Исходный код будет сохранён в каталоге кэша.
-g, --git: Создать репозиторий Git, полезный для создания исправлений для программного обеспечения.
--cask: Считать все именованные аргументы cask-пакетами.
--[no-]binaries: Отключить/включить создание ссылок на вспомогательные исполняемые файлы (по умолчанию включено).
--require-sha: Требовать наличие контрольной суммы для всех cask-пакетов.
--adopt: Использовать существующие артефакты в целевом каталоге, идентичные устанавливаемым. Нельзя использовать вместе с --force.
--skip-cask-deps: Пропустить установку зависимостей cask-пакета.
--zap: Использовать вместе с brew reinstall --cask. Удалить все файлы, связанные с cask-пакетом. Могут быть удалены файлы, общие для нескольких приложений.

`sandbox-exec` [`--deny-network`] `writable-path` [`--`] `command` [`args` …]

Запустить command в изолированной среде Homebrew, разрешив запись в writable-path, а также во временные каталоги и каталоги кэша Homebrew.

Пример: brew sandbox-exec . -- make test

--deny-network: Запретить доступ к сети из изолированной среды.

`search`, `-S` [`options`] `text`|`/``regex``/` […]

Выполнить поиск по подстроке среди токенов cask-пакетов и названий формул по запросу text. Если запрос text заключён в косые черты, он интерпретируется как регулярное выражение.

--formula: Искать формулы.
--cask: Искать cask-пакеты.
--desc: Искать формулы с описанием, соответствующим запросу text, и cask-пакеты с названием или описанием, соответствующим запросу text.
--pull-request: Искать запросы на включение изменений GitHub, содержащие text.
--open: Искать только открытые запросы на включение изменений GitHub.
--closed: Искать только закрытые запросы на включение изменений GitHub.
--alpine: Искать text в указанной базе данных.
--repology: Искать text в указанной базе данных.
--macports: Искать text в указанной базе данных.
--fink: Искать text в указанной базе данных.
--opensuse: Искать text в указанной базе данных.
--fedora: Искать text в указанной базе данных.
--archlinux: Искать text в указанной базе данных.
--debian: Искать text в указанной базе данных.
--ubuntu: Искать text в указанной базе данных.

`services` [`subcommand`]

Управлять фоновыми службами с помощью диспетчера демонов macOS launchctl(1) или диспетчера служб Linux systemctl(1).

Если передан параметр sudo, управлять /Library/LaunchDaemons или /usr/lib/systemd/system (запуск при загрузке). В противном случае управлять ~/Library/LaunchAgents или ~/.config/systemd/user (запуск при входе в систему).

--sudo-service-user: При запуске от имени root в macOS запускать службу или службы от имени этого пользователя.
[sudo] brew services stop [--keep] [--no-wait|--max-wait=] (formula|--all): Немедленно остановить службу formula и отменить её регистрацию для запуска при входе в систему (или загрузке), если не указан параметр --keep.
--max-wait: Подождать не более указанного числа секунд, пока stop завершит остановку службы. По умолчанию — 60. Укажите ноль (0) секунд, чтобы ждать бесконечно.
--no-wait: Не ждать, пока stop завершит остановку службы.
--keep: После остановки не отменять регистрацию службы для запуска при входе в систему (или загрузке).
--all: Остановить все службы и отменить их регистрацию для запуска при входе в систему (или загрузке), если не указан параметр --keep.
[sudo] brew services start (formula|--all) [--file=]: Немедленно запустить службу formula и зарегистрировать её для запуска при входе в систему (или загрузке).
--file: Использовать файл службы из этого расположения, чтобы start службу.
--all: Запустить все службы и зарегистрировать их для запуска при входе в систему (или загрузке).
[sudo] brew services run (formula|--all) [--file=]: Запустить службу formula без регистрации для запуска при входе в систему (или загрузке).
--file: Использовать файл службы из этого расположения, чтобы run службу.
--all: Запустить все службы без регистрации для запуска при входе в систему (или загрузке).
[sudo] brew services restart (formula|--all) [--file=]: При необходимости остановить, а затем немедленно запустить службу formula и зарегистрировать её для запуска при входе в систему (или загрузке).
--file: Использовать файл службы из этого расположения, чтобы start службу.
--all: Перезапустить все службы.
[sudo] brew services [list] [--json] [--debug]: Вывести сведения обо всех управляемых службах текущего пользователя (или root). При запуске с параметром --debug выводит больше сведений от Homebrew и launchctl(1) или systemctl(1).
--json: Выводить данные в формате JSON.
[sudo] brew services kill (formula|--all): Немедленно остановить службу formula, но сохранить её регистрацию для запуска при входе в систему (или загрузке).
--all: Немедленно остановить все службы, но сохранить их регистрацию для запуска при входе в систему (или загрузке).
[sudo] brew services info (formula|--all) [--json]: Вывести список всех управляемых служб текущего пользователя (или root).
--all: Вывести список всех управляемых служб.
--json: Выводить данные в формате JSON.
[sudo] brew services cleanup: Удалить все неиспользуемые службы.

`setup-ruby` [`command` …]

Устанавливает и настраивает Ruby для Homebrew. Если передан параметр command, Bundler будет запущен только при необходимости для этой команды.

`setup-sandbox`

Выполнить все необходимые команды для настройки изолированной среды Homebrew. Необходимо запускать с параметром sudo. В настоящее время ничего не делает в системах, отличных от Linux.

`shellenv` [`shell` …]

Допустимые оболочки: bash|csh|fish|pwsh|sh|tcsh|zsh

Вывести инструкции export. При запуске из оболочки эта установка Homebrew будет добавлена в $PATH, $MANPATH и $INFOPATH.

Также экспортируются переменные $HOMEBREW_PREFIX, $HOMEBREW_CELLAR и $HOMEBREW_REPOSITORY, чтобы избежать повторных запросов их значений. Чтобы обеспечить идемпотентность, команда ничего не выводит, если каталоги Homebrew bin и sbin занимают соответственно первое и второе места в $PATH. Рекомендуется добавить выполнение этой команды в ваши dotfiles (например, ~/.bash_profile или ~/.zprofile on macOS and ~/.bashrc или ~/.zshrcon Linux) with e.g.:eval “$(brew shellenv zsh)” or eval “$(brew shellenv bash)”`

Оболочку следует явно указать параметром с названием поддерживаемой оболочки, однако, если он не задан, она будет определена автоматически (это определение может быть неверным). Для неизвестных оболочек будут выведены POSIX-инструкции export.

`source` [`formula` …]

Открыть в браузере исходный репозиторий formula или, если аргумент не указан, собственный репозиторий Homebrew.

URL репозитория определяется по URL head-версии формулы, стабильной версии или главной страницы. Поддерживаются репозитории GitHub, GitLab, Bitbucket, Codeberg и SourceHut.

`tab` [`options`] `installed_formula`|`installed_cask` […]

Изменить сведения о tab для установленных формул или cask-пакетов.

Это может пригодиться, если нужно управлять тем, будет ли установленная формула удалена командой brew autoremove. Чтобы предотвратить удаление, отметьте формулу как установленную по запросу; чтобы разрешить удаление, отметьте её как не установленную по запросу.

--installed-on-request: Отметить installed_formula или installed_cask как установленную по запросу.
--no-installed-on-request: Отметить installed_formula или installed_cask как не установленную по запросу.
--formula: Отмечать только формулы.
--cask: Отмечать только cask-пакеты.

`tap` [`options`] [`user``/``repo`] [`URL`]

Добавить tap с репозиторием формул. Если аргументы не указаны, вывести список всех установленных taps.

Если URL не задан, добавить tap с репозиторием формул из GitHub через HTTPS. Поскольку на GitHub размещено так много taps, эта команда является сокращённой формой для brew tap user/repo https://github.com/user/homebrew-repo.

Если задан URL, можно добавить tap с репозиторием формул из любого источника, используя любой протокол передачи данных, поддерживаемый git(1). Одноаргументный вариант tap проще, но имеет ограничения. Эта команда с двумя аргументами не делает никаких предположений, поэтому taps можно клонировать не только с GitHub и использовать протоколы, отличные от HTTPS, например SSH, git, HTTP, FTP(S), rsync.

--custom-remote: Установить tap или изменить его на tap с пользовательским удалённым репозиторием. Полезно для зеркал.
--repair: Добавить отсутствующие символические ссылки на справочные страницы man и дополнения командной оболочки для tap. Исправить ссылки на удалённые ветки Git для taps, в которых upstream-ветка HEAD была переименована.
-f, --force: Принудительно установить основные taps даже в режиме API.

`tap-info` [`--installed`] [`--json`] [`tap` …]

Показать подробную информацию об одном или нескольких tap. Если названия tap не указаны, вывести краткую статистику по всем установленным taps.

--installed: Показать информацию о каждом установленном tap.
--json: Вывести представление tap в формате JSON. В настоящее время значением по умолчанию и единственным допустимым значением для version является v1. Примеры использования вывода JSON см. в документации: https://docs.brew.sh/Querying-Brew

`trust` [`options`] [`target` …]

Доверять формулам, cask-пакетам или командам из неофициальных taps, чтобы Homebrew мог загружать их, если задано $HOMEBREW_REQUIRE_TAP_TRUST. Доверенные записи хранятся в ${XDG_CONFIG_HOME}/homebrew/trust.json, если задано $XDG_CONFIG_HOME, и в ~/.homebrew/trust.json в противном случае.

--tap: Доверять указанному tap.
--formula: Доверять указанной формуле.
--cask: Доверять указанному cask-пакету.
--command: Доверять указанной внешней команде.
--json: Вывести доверенные записи в формате JSON. Требуется номер версии version. Единственным допустимым значением для version является v1.

`unalias` `alias` […]

Удалить псевдонимы.

`uninstall`, `remove`, `rm` [`options`] `installed_formula`|`installed_cask` […]

Удалить formula или cask.

-f, --force: Удалить все установленные версии formula. Выполнить удаление, даже если cask не установлен, перезаписать существующие файлы и игнорировать ошибки при удалении файлов.
--zap: Удалить все файлы, связанные с cask. Могут быть удалены файлы, общие для нескольких приложений.
--ignore-dependencies: Не считать удаление неудачным, даже если formula является зависимостью какой-либо установленной формулы.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`unlink` [`--dry-run`] `installed_formula` […]

Удалить символические ссылки на formula из префикса Homebrew. Это может пригодиться для временного отключения формулы: brew unlink formula && commands && brew link formula

-n, --dry-run: Вывести список файлов, для которых были бы удалены ссылки, не удаляя сами ссылки или файлы.

`unpin` [`--formula`] [`--cask`] `installed_formula`|`installed_cask` […]

Открепить указанный пакет, разрешив его обновление командами brew upgrade formula или cask. См. также pin.

--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`untap` [`--force`] `tap` […]

Удалить tap с репозиторием формул.

-f, --force: Удалить tap, даже если формулы или cask-пакеты из него в данный момент установлены.

`untrust` [`options`] [`target` …]

Отозвать доверие к формулам, cask-пакетам или командам из неофициальных taps. Доверенные записи хранятся в ${XDG_CONFIG_HOME}/homebrew/trust.json, если задано $XDG_CONFIG_HOME, и в ~/.homebrew/trust.json в противном случае.

--tap: Отозвать доверие к указанному tap.
--formula: Отозвать доверие к указанной формуле.
--cask: Отозвать доверие к указанному cask-пакету.
--command: Отозвать доверие к указанной внешней команде.

`update`, `up` [`options`]

Загрузить с GitHub новейшую версию Homebrew и всех формул с помощью git(1) и выполнить необходимые миграции.

--auto-update: Выполнять при автоматическом обновлении (например, перед brew install). Пропускает некоторые более медленные этапы.
-f, --force: Всегда выполнять более медленную полную проверку обновлений (даже если в ней нет необходимости).
-v, --verbose: Вывести проверенные каталоги и выполненные операции git.
-d, --debug: Выводить трассировку всех выполняемых команд оболочки.

`update-if-needed`

Запускает brew update --auto-update только при необходимости. Это хорошая замена brew update в сценариях, где нужен вариант без действий, который действительно выполняется очень быстро.

`update-reset` [`repository` …]

Загрузить обновления Homebrew и всех репозиториев taps (или любых указанных repository) и сбросить их с помощью git(1) до последних версий origin/HEAD.

Примечание: это уничтожит все ваши незакоммиченные или закоммиченные изменения.

`upgrade` [`options`] [`installed_formula`|`installed_cask` …]

Обновить устаревшие незакреплённые пакеты, используя те же параметры, с которыми они были установлены изначально, а также любые дополнительные параметры brew для формул. Если указаны cask или formula, обновлять только указанную cask или formula (если они не закреплены; см. pin, unpin).

Если не задано $HOMEBREW_NO_INSTALL_CLEANUP, для обновлённых формул будет выполнено brew cleanup, а для всех формул — раз в 30 дней.

-d, --debug: Если сборка завершится с ошибкой, открыть интерактивный сеанс отладки с доступом к IRB или оболочке во временном каталоге сборки.
--display-times: В конце выполнения вывести время установки для каждого пакета. Включено по умолчанию, если задано $HOMEBREW_DISPLAY_INSTALL_TIMES.
-f, --force: Устанавливать формулы, не проверяя наличие ранее установленных версий только для keg или версий, которые не были перенесены. При установке cask-пакетов перезаписывать существующие файлы (исполняемые файлы и символические ссылки исключены, если изначально они не принадлежали тому же cask-пакету).
-v, --verbose: Вывести этапы проверки и действия после установки.
-n, --dry-run: Показать, что будет обновлено, но не выполнять обновление.
--minimum-version: Обновлять только указанную формулу или cask-пакет, установленная версия которого ниже заданной минимальной версии.
-y, --no-ask: Не запрашивать подтверждение перед загрузкой и обновлением. По умолчанию используется режим запроса подтверждения. Включено по умолчанию, если задано $HOMEBREW_NO_ASK.
--formula: Считать все именованные аргументы формулами. Если именованные аргументы не указаны, обновлять только устаревшие формулы.
-s, --build-from-source: Собирать formula из исходного кода, даже если доступен bottle.
-i, --interactive: Загрузить и исправить formula, а затем открыть оболочку. Это позволяет пользователю выполнить ./configure --help и другим способом определить, как превратить программный пакет в пакет Homebrew.
--force-bottle: Установить из bottle, если он доступен для текущей или самой новой версии macOS, даже если обычно он не использовался бы для установки.
--fetch-HEAD: Получить репозиторий upstream, чтобы определить, устарела ли установка формулы из HEAD. В противном случае HEAD репозитория будет проверяться на наличие обновлений только при выпуске новой стабильной или разрабатываемой версии.
--keep-tmp: Сохранить временные файлы, созданные во время установки.
--debug-symbols: Создать отладочные символы при сборке. Исходный код будет сохранён в каталоге кэша.
--overwrite: Удалить файлы, уже существующие в префиксе, при создании ссылок.
--cask: Считать все именованные аргументы cask-пакетами. Если именованные аргументы не указаны, обновлять только устаревшие cask-пакеты.
--skip-cask-deps: Не устанавливать зависимости cask-пакетов.
--no-quit: Не закрывать запущенные приложения cask-пакетов во время обновления. Включено по умолчанию, если задано $HOMEBREW_NO_UPGRADE_QUIT_CASKS.
-g, --greedy: Также включать cask-пакеты с version :latest и auto_updates true cask-пакеты, которые в противном случае были бы пропущены. Включено по умолчанию, если задано $HOMEBREW_UPGRADE_GREEDY.
--greedy-latest: Также включать cask-пакеты с version :latest.
--greedy-auto-updates: Также включать auto_updates true cask-пакеты, которые в противном случае были бы пропущены.
--[no-]binaries: Отключить или включить создание ссылок на вспомогательные исполняемые файлы (по умолчанию включено).
--require-sha: Требовать наличия контрольной суммы у всех cask-пакетов.

`uses` [`options`] `formula` […]

Показать формулы и cask-пакеты, указывающие formula в качестве зависимости; то есть показать зависимые от formula. Если указано несколько аргументов-формул, показать пересечение формул, использующих formula. По умолчанию uses показывает все формулы и cask-пакеты, в которых formula указан как обязательная или рекомендуемая зависимость для стабильных сборок.

Примечание: --missing и --skip-recommended имеют приоритет над --include-*.

--recursive: Разрешить зависимости более чем на одном уровне.
--installed: Показывать только установленные формулы и cask-пакеты.
--missing: Показывать только неустановленные формулы и cask-пакеты.
--include-implicit: Включить формулы, у которых formula является неявной зависимостью для загрузки и распаковки исходных файлов.
--include-build: Включить формулы, в которых formula указан как зависимость типа :build.
--include-test: Включить формулы, в которых formula указан как зависимость типа :test.
--include-optional: Включить формулы, в которых formula указана как зависимость типа :optional.
--skip-recommended: Пропустить все формулы, в которых formula указана как зависимость типа :recommended.
--formula: Включить только формулы.
--cask: Включить только cask-пакеты.

`version-install` `formula`[@`version`] [`version`]

Извлечь определённую version версии formula в персональный tap и установить её. По умолчанию используется tap user/versions. В user используется имя пользователя GitHub, если оно доступно, и в противном случае локальное имя пользователя.

`which-formula` [`--explain`] `command` […]

Показать, какая формула предоставляет указанную команду.

--explain: Вывести объяснение того, как получить command, установив одну из предоставляющих её формул.

`--cache` [`options`] [`formula`|`cask` …]

Показать кэш загрузок Homebrew. См. также $HOMEBREW_CACHE.

Если указана formula или cask, показать файл или каталог, используемый для её кэширования.

--os: Показать файл кэша для указанной операционной системы. (Передайте all, чтобы показать файлы кэша для всех операционных систем.)
--arch: Показать файл кэша для указанной архитектуры процессора. (Передайте all, чтобы показать файлы кэша для всех архитектур.)
-s, --build-from-source: Показать файл кэша, используемый при сборке из исходного кода.
--force-bottle: Показать файл кэша, используемый при установке bottle.
--bottle-tag: Показать файл кэша, используемый при установке bottle для указанного тега.
--HEAD: Показать файл кэша, используемый при сборке из HEAD.
--formula: Показывать только файлы кэша для формул.
--cask: Показывать только файлы кэша для cask-пакетов.

`--caskroom` [`cask` …]

Показать путь к Caskroom в Homebrew.

Если указана cask, показать расположение в Caskroom, куда будет установлен cask, без каталога с номером версии в конце пути.

`--cellar` [`formula` …]

Показать путь к Cellar в Homebrew. По умолчанию: $(brew --prefix)/Cellar или, если этот каталог не существует, $(brew --repository)/Cellar.

Если указана formula, показать расположение в Cellar, куда будет установлена formula, без каталога с номером версии в конце пути.

`--env`, `environment` [`--shell=`] [`--plain`] [`formula` …]

Вывести сводку о среде сборки Homebrew в виде простого списка.

Если вывод команды передаётся через конвейер и оболочка не указана, список форматируется для экспорта в bash(1), если не передан параметр --plain.

--shell: Создать список переменных среды для указанной оболочки или использовать --shell=auto для определения текущей оболочки.
--plain: Формировать простой вывод, даже если он передаётся через конвейер.

`--prefix` [`--unbrewed`] [`--installed`] [`formula` …]

Показать путь установки Homebrew. По умолчанию:

macOS ARM: /opt/homebrew
macOS Intel: /usr/local
Linux: /home/linuxbrew/.linuxbrew

Если указана formula, показать расположение, куда установлена или будет установлена formula.

--unbrewed: Вывести список файлов в префиксе Homebrew, которые не были установлены Homebrew.
--installed: Ничего не выводить и вернуть код завершения с ошибкой, если formula не установлена.

`--repository`, `--repo` [`tap` …]

Показать расположение Git-репозитория Homebrew.

Если указаны user/repo, показать расположение каталога tap user/repo.

`--taps`

Показать путь к каталогу Taps в Homebrew.

`--version`, `-v`

Вывести в стандартный поток вывода номера версий Homebrew, Homebrew/homebrew-core и Homebrew/homebrew-cask (если tap добавлен).

КОМАНДЫ ДЛЯ РАЗРАБОТЧИКОВ

`audit` [`options`] [`formula`|`cask` …]

Проверить formula или cask на соответствие стилю написания кода Homebrew. Эту команду следует выполнять перед отправкой новой формулы или cask-пакета. Если formula или cask не указаны, проверить все доступные локально формулы и cask-пакеты и пропустить проверку стиля. Команда завершится с ненулевым кодом, если обнаружены ошибки.

--os: Проверить указанную операционную систему. (Передайте all, чтобы проверить все операционные системы.)
--arch: Проверить указанную архитектуру процессора. (Передайте all, чтобы проверить все архитектуры.)
--strict: Выполнить дополнительные, более строгие проверки стиля.
--git: Выполнить дополнительные, более медленные проверки стиля с просмотром Git-репозитория.
--online: Выполнить дополнительные, более медленные проверки стиля, требующие подключения к сети.
--installed: Проверять только установленные формулы и cask-пакеты.
--new: Выполнить дополнительные проверки стиля, чтобы определить, подходит ли новая формула или cask-пакет для Homebrew. Этот параметр следует использовать при создании новых формул или cask-пакетов; он подразумевает --strict и --online.
--changed: Проверить файлы, изменённые относительно ветки main.
--tap: Проверить формулы и cask-пакеты в указанном tap, заданном как user/repo.
--fix: Автоматически исправить нарушения стиля с помощью функции автоисправления RuboCop.
--display-filename: Добавлять в начало каждой строки вывода имя проверяемого файла или формулы, чтобы упростить поиск в выводе с помощью grep.
--skip-style: Не выполнять проверки стиля, отличные от RuboCop. Полезно, если вы собираетесь отдельно запустить brew style. Включено по умолчанию, если формула не указана по имени.
-D, --audit-debug: Включить отладку и профилирование методов аудита.
--only: Указать разделённый запятыми список method, чтобы запускать только методы с именами audit_method.
--except: Указать разделённый запятыми список method, чтобы пропустить методы с именами audit_method.
--only-cops: Указать разделённый запятыми список cops, чтобы проверять нарушения только перечисленных правил RuboCop.
--except-cops: Указать разделённый запятыми список cops, чтобы пропустить проверку нарушений перечисленных правил RuboCop.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`bottle` [`options`] `installed_formula`|`file` […]

Создать bottle (бинарный пакет) из формулы, установленной с помощью --build-bottle. Если в формуле указана версия пересборки, она будет увеличена в сгенерированном DSL. Параметр --keep-old попытается сохранить исходное значение, а --no-rebuild удалит его.

--skip-relocation: Не проверять, можно ли пометить bottle как перемещаемый.
--force-core-tap: Создать bottle, даже если formula отсутствует в homebrew/core и во всех установленных tap.
--no-rebuild: Если в формуле указана версия пересборки, удалить её из сгенерированного DSL.
--keep-old: Если в формуле указана версия пересборки, попытаться сохранить её значение в сгенерированном DSL.
--json: Записать сведения о bottle в файл JSON, который можно использовать в качестве значения для --merge.
--merge: Создать обновлённый блок bottle для формулы и при необходимости объединить его с файлом формулы. Вместо имени формулы требуется путь к файлу JSON, созданному с помощью brew bottle --json formula.
--write: Записать изменения в файл формулы. Будет создан новый коммит, если не передан параметр --no-commit.
--no-commit: Если передан вместе с --write, новый коммит после записи изменений в файл формулы создан не будет.
--only-json-tab: Если передан вместе с --json, tab будет записан в файл JSON, но не в bottle.
--no-all-checks: Не пытаться создавать bottle типа all и не останавливать загрузку, если изменений нет.
--root-url: Использовать указанный URL в качестве корневого URL bottle вместо значения по умолчанию Homebrew.
--root-url-using: Использовать указанный класс стратегии загрузки для скачивания bottle по его URL вместо значения по умолчанию Homebrew.

`bump` [`options`] [`formula`|`cask` …]

Показать устаревшие пакеты и последние доступные версии. Если возвращённые версии current и livecheck различаются или запрашиваются определённые пакеты, также показать, создан ли pull request, и его URL.

--full-name: Вывести формулы и cask-пакеты с полными именами.
--no-pull-requests: Не получать pull request с GitHub.
--no-autobump: Игнорировать формулы и cask-пакеты из списка autobump (только официальные репозитории).
--formula: Проверять только формулы.
--cask: Проверять только cask-пакеты.
--repology: Использовать Repology для проверки устаревших пакетов.
--tap: Проверить формулы и cask-пакеты в указанном tap, заданном как user/repo.
--installed: Проверить установленные формулы и cask-пакеты.
--no-fork: Не пытаться создать форк репозитория.
--open-pr: Создать pull request для новой версии, если такой ещё не создан.
--start-with: Буква или слово, по которому следует сортировать список результатов пакетов.
--bump-synced: Обновить дополнительные формулы, помеченные как синхронизированные с указанными формулами.

`bump-cask-pr` [`options`] `cask`

Создать pull request для обновления cask до новой версии.

Если пользователь не указал SHA-256, будет предпринята попытка определить его наилучшим образом.

-n, --dry-run: Вывести предполагаемые действия, не выполняя их.
--write-only: Внести ожидаемые изменения в файлы, не выполняя никаких действий Git.
--commit: При передаче вместе с --write-only создать новый коммит после записи изменений в файл cask-пакета.
--no-audit: Не запускать brew audit перед созданием PR.
--no-style: Не запускать brew style --fix перед созданием PR.
--no-browse: Вывести URL pull request вместо открытия в браузере.
--no-fork: Не пытаться создать форк репозитория.
--version: Указать новую version для cask-пакета.
--version-arm: Указать новую version cask-пакета для архитектуры ARM.
--version-intel: Указать новую version cask-пакета для архитектуры Intel.
--message: Добавить message в начало сообщения pull request по умолчанию.
--url: Указать URL для новой загрузки.
--sha256: Указать контрольную сумму SHA-256 новой загрузки.
--fork-org: Использовать указанную организацию GitHub для создания форка.

`bump-compatibility-version` [`options`] `formula` […]

Создать коммит, увеличивающий compatibility_version у formula. Если compatibility_version отсутствует, будет добавлено «compatibility_version 1».

-n, --dry-run: Вывести предполагаемые действия, не выполняя их.
--write-only: Внести ожидаемые изменения в файлы, не выполняя никаких действий Git.
--message: Добавить message в конец сообщения коммита по умолчанию.

`bump-formula-pr` [`options`] [`formula`]

Создать pull request для обновления formula с новым URL или тегом.

Если указан URL, также следует указать контрольную сумму SHA-256 новой загрузки. Если пользователь не указал SHA-256, будет предпринята попытка определить его наилучшим образом.

Если указан tag, также следует указать Git-коммит revision, соответствующий этому тегу. Если пользователь не указал revision, будет предпринята попытка определить его наилучшим образом.

Если указан version, будет предпринята попытка определить URL и SHA-256 либо tag и revision, если пользователь не указал оба значения.

Примечание: эту команду нельзя использовать для перехода от спецификации формулы в формате URL и SHA-256 к спецификации в формате тега и ревизии или наоборот. Необходимо использовать тот формат спецификации, который уже применяется в формуле.

-n, --dry-run: Вывести предполагаемые действия, не выполняя их.
--write-only: Внести ожидаемые изменения в файлы, не выполняя никаких действий Git.
--commit: При передаче вместе с --write-only создать новый коммит после записи изменений в файл формулы.
--no-audit: Не запускать brew audit перед созданием PR.
--strict: Запустить brew audit --strict перед созданием PR.
--online: Запустить brew audit --online перед созданием PR.
--no-browse: Вывести URL pull request вместо открытия в браузере.
--no-fork: Не пытаться создать форк репозитория.
--mirror: Использовать указанный URL в качестве URL зеркала. Если URL — это список URL, разделённых запятыми, будут добавлены несколько зеркал.
--fork-org: Использовать указанную организацию GitHub для создания форка.
--version: Использовать указанный version вместо значения, извлечённого из URL или тега. Обратите внимание: --version=0 можно использовать, чтобы удалить существующее переопределение версии из формулы, если оно стало избыточным.
--message: Добавить message в начало сообщения pull request по умолчанию.
--url: Указать URL для новой загрузки. Если указан URL, также следует указать контрольную сумму SHA-256 новой загрузки.
--sha256: Указать контрольную сумму SHA-256 новой загрузки.
--tag: Указать новый Git-коммит tag для формулы.
--revision: Указать новый коммит revision, соответствующий указанному Git-тегу tag или указанному version.
-f, --force: Удалить все зеркала, если не указан параметр --mirror.
--install-dependencies: Установить отсутствующие зависимости, необходимые для обновления ресурсов.
--python-package-name: Использовать указанный package-name при поиске ресурсов Python для formula. Если имя пакета не указано, оно будет определено по стабильному URL формулы.
--python-extra-packages: Включить эти дополнительные пакеты Python при поиске ресурсов.
--python-exclude-packages: Исключить эти пакеты Python при поиске ресурсов.

`bump-revision` [`options`] `formula` […]

Создать коммит, увеличивающий ревизию formula. Если ревизия отсутствует, будет добавлено «revision 1».

-n, --dry-run: Вывести предполагаемые действия, не выполняя их.
--remove-bottle-block: Помимо увеличения ревизии, удалить блок bottle.
--write-only: Внести ожидаемые изменения в файлы, не выполняя никаких действий Git.
--message: Добавить message в конец сообщения коммита по умолчанию.

`bump-unversioned-casks` [`options`] `cask`|`tap` […]

Проверить все cask-пакеты с URL без версии в указанном tap на наличие обновлений.

-n, --dry-run: Выполнить все действия, кроме кэширования состояния и создания pull request.
--limit: Максимальное время выполнения в минутах.
--state-file: Файл для кэширования состояния.

`cat` [`--formula`] [`--cask`] `formula`|`cask` […]

Показать исходный код formula или cask.

--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask-пакетами.

`contributions` [`--user=`] [`--repositories=`] [`--quarter=`] [`--from=`] [`--to=`] [`--csv`]

Составить сводку о вкладах в репозитории Homebrew.

--user: Указать разделённый запятыми список имён пользователей GitHub или адресов электронной почты, чтобы найти их вклады. Если этот параметр не указан, выполняется поиск вкладов сопровождающих Homebrew.
--repositories: Указать разделённый запятыми список репозиториев для поиска. Все репозитории должны принадлежать одному пользователю или одной организации. Если параметр не указан или задан --repositories=primary, поиск выполняется только в основных репозиториях: Homebrew/brew, Homebrew/homebrew-core, Homebrew/homebrew-cask.
--organisation: Указать организацию, из которой следует выбрать исходные репозитории. Если параметр не указан, поиск выполняется в основных репозиториях Homebrew.
--team: Указать команду, из которой следует выбрать пользователей. Первая часть имени команды будет использована в качестве названия организации.
--quarter: Квартал вкладов в Homebrew для поиска (1–4). Если параметр не указан, выполняется поиск за прошедший год. Если заданы --from или --to, они имеют приоритет.
--from: Дата начала поиска вкладов в формате ISO 8601. Если параметр не указан, выполняется поиск за прошедший год.
--to: Дата окончания поиска вкладов в формате ISO 8601.
--csv: Вывести CSV-файл со сведениями о вкладах в репозитории за указанный период.

`create` [`options`] `URL`

Создать формулу или, если указан параметр --cask, cask-пакет для загружаемого файла по адресу URL и открыть его в редакторе. Homebrew попытается автоматически определить имя и версию формулы, но, если это не удастся, вам придётся создать шаблон самостоятельно. Формула wget служит простым примером. Полное описание API см. здесь: https://docs.brew.sh/rubydoc/Formula

--autotools: Создать базовый шаблон сборки в стиле Autotools.
--cabal: Создать базовый шаблон сборки Cabal.
--cask: Создать базовый шаблон для cask.
--cmake: Создать базовый шаблон сборки в стиле CMake.
--crystal: Создать базовый шаблон сборки Crystal.
--go: Создать базовый шаблон сборки Go.
--meson: Создать базовый шаблон сборки в стиле Meson.
--node: Создать базовый шаблон сборки Node.
--perl: Создать базовый шаблон сборки Perl.
--python: Создать базовый шаблон сборки Python.
--ruby: Создать базовый шаблон сборки Ruby.
--rust: Создать базовый шаблон сборки Rust.
--zig: Создать базовый шаблон сборки Zig.
--no-fetch: Homebrew не будет загружать URL в кэш и поэтому не добавит за вас его SHA-256 в формулу, а также не будет обращаться к API GitHub для проектов на GitHub (чтобы заполнить описание и домашнюю страницу).
--HEAD: Указать, что URL ведёт на репозиторий пакета, а не на файл.
--set-name: Явно задать name новой формулы или cask.
--set-version: Явно задать version новой формулы или cask.
--set-license: Явно задать license новой формулы.
--tap: Создать новую формулу в указанном tap, заданном в виде user/repo.
-f, --force: Игнорировать ошибки, связанные с недопустимыми именами формул и именами, совпадающими с псевдонимами.

`debugger` [`--open`] `command` […]

Запустить указанную команду Homebrew в режиме отладки.

Чтобы передать команде флаги, используйте -- для отделения их от флагов brew. Например: brew debugger -- list --formula.

-O, --open: Запустить удалённую отладку через сокет Unix.

`edit` [`options`] [`formula`|`cask`|`tap` …]

Открыть formula, cask или tap в редакторе, заданном с помощью $EDITOR или $HOMEBREW_EDITOR, либо открыть репозиторий Homebrew для редактирования, если аргумент не указан.

--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask.
--print-path: Вывести путь к файлу для редактирования, не открывая редактор.

`extract` [`--version=`] [`--git-revision=`] [`--force`] `formula` `tap`

Просмотреть историю репозитория, найти последнюю версию formula и создать её копию в tap. В частности, команда создаст новый файл формулы по пути tap/Formula/formula@version.rb. Если tap ещё не установлен, перед продолжением будет предпринята попытка установить или клонировать его. Чтобы извлечь формулу из tap, который не является homebrew/core, используйте её полное имя в виде user/repo/formula.

--git-revision: Искать указанную version для formula, начиная с revision, а не с HEAD.
--version: Извлечь указанную version для formula вместо последней.
-f, --force: Перезаписать формулу назначения, если она уже существует.

`formula` `formula` […]

Показать путь, по которому находится formula.

`generate-man-completions` [`--no-exit-code`]

Создать man-страницы и автодополнения командной оболочки Homebrew.

--no-exit-code: Завершить работу с кодом 0, даже если изменений не было.

`generate-zap` [`--name`] `cask_or_name`

Создать секцию zap для cask, просканировав систему на наличие связанных файлов и каталогов.

Принимает токен cask (например, firefox) или, с параметром --name, строку с обычным названием приложения (например, Firefox). Если указан токен cask, название приложения определяется по артефакту app этого cask.

Целевое приложение должно быть запущено хотя бы один раз, чтобы файлы настроек и кэши появились на диске.

Выводит директивы trash, delete и rmdir, которые можно вставить в определение cask.

--name: Считать аргумент обычным названием приложения, а не токеном cask.

`install-bundler-gems` [`--groups=`] [`--add-groups=`]

Установить гемы Bundler для Homebrew.

--groups: Установить указанный список групп гемов, разделённых запятыми (по умолчанию — последние использованные). Заменяет все ранее установленные группы.
--add-groups: Установить указанный список групп гемов, разделённых запятыми, в дополнение к уже установленным.

`irb` [`--examples`] [`--pry`]

Открыть интерактивную оболочку Ruby для Homebrew.

--examples: Показать несколько примеров.
--pry: Использовать Pry вместо IRB. Включено по умолчанию, если задан $HOMEBREW_PRY.

`lgtm` [`--online`]

За один запуск выполнить brew typecheck, brew style --changed и соответствующие проверки brew tests, brew audit и brew test.

--online: Выполнить дополнительные, более медленные проверки, требующие подключения к сети.

`linkage` [`options`] [`installed_formula` …]

Проверить связи библиотек для указанных установленных кегов formula. Если formula не указаны, проверить все кеги. При запуске для неустановленных формул возникает ошибка.

--test: Показывать только отсутствующие библиотеки и завершить работу с ненулевым кодом, если найдена хотя бы одна отсутствующая библиотека.
--strict: Завершить работу с ненулевым кодом, если обнаружены незаявленные зависимости с привязкой.
--reverse: Для каждой библиотеки, на которую ссылается keg, вывести путь к её dylib, а затем двоичные файлы, связанные с ней.
--cached: Вывести кэшированные значения связей, сохранённые в $HOMEBREW_CACHE предыдущим запуском brew linkage.

`livecheck`, `lc` [`options`] [`formula`|`cask` …]

Проверить наличие новых версий формул и/или cask в вышестоящих источниках. Если аргумент с формулой или cask не передан, список проверяемых формул и cask берётся из $HOMEBREW_LIVECHECK_WATCHLIST или ${XDG_CONFIG_HOME}/homebrew/livecheck_watchlist.txt, если задан $XDG_CONFIG_HOME, либо из ~/.homebrew/livecheck_watchlist.txt в противном случае.

--full-name: Выводить полные имена формул и cask.
--tap: Проверить формулы и cask в указанном tap, заданном в виде user/repo.
--installed: Проверить установленные в данный момент формулы и cask.
--newer-only: Показывать последнюю версию, только если она новее текущей версии формулы или cask.
--json: Выводить данные в формате JSON.
-r, --resources: Также проверять ресурсы формул.
-q, --quiet: Подавлять предупреждения и не выводить индикатор выполнения для вывода JSON.
--formula: Проверять только формулы.
--cask: Проверять только cask.
--extract-plist: Включить проверку нескольких cask с помощью стратегии ExtractPlist.
--autobump: Включить пакеты, версии которых автоматически обновляет BrewTestBot. По умолчанию они пропускаются.

`prof` [`--stackprof`] [`--vernier`] `command` […]

Запустить Homebrew с профилировщиком Ruby. Например, brew prof readall.

--stackprof: Использовать stackprof вместо ruby-prof (по умолчанию).
--vernier: Использовать vernier вместо ruby-prof (по умолчанию).

`rubocop`

Установить, настроить и запустить rubocop для Homebrew.

`ruby` [`options`] (`-e` `text`|`file`)

Запустить экземпляр Ruby с загруженными библиотеками Homebrew. Например, brew ruby -e "puts :gcc.f.deps" или brew ruby script.rb.

Например, запустите brew ruby -- --version, чтобы передать произвольные аргументы в ruby.

-r: Загрузить библиотеку с помощью require.
-e: Выполнить указанную текстовую строку как скрипт.

`rubydoc` [`--only-public`] [`--open`]

Создать документацию RubyDoc для Homebrew.

--only-public: Создать только документацию публичного API.
--open: Открыть созданную документацию в браузере.

`sh` [`options`] [`file`]

Открыть интерактивную оболочку среды сборки Homebrew. Используйте отлаженную годами логику сборки, чтобы успешно собрать ваш ./configure && make && make install и даже ваш gem install. Особенно удобно, если Homebrew работает в конфигурации только с Xcode: в этом случае такие инструменты, как make, добавляются в ваш $PATH, где системы сборки иначе их не найдут.

С параметром --ruby открывается интерактивная оболочка среды Ruby Homebrew. Она настраивает правильные пути Ruby, $GEM_HOME и конфигурацию bundle, используемые инструментами разработки Homebrew. Среда включает гемы из установленных групп, благодаря чему такие инструменты, как RuboCop, Sorbet и RSpec, доступны через bundle exec.

-r, --ruby: Настроить среду Ruby для Homebrew.
--env: Использовать стандартный $PATH вместо superenv, если передан параметр std.
-c, --cmd: Выполнять команды в неинтерактивной оболочке.

`style` [`options`] [`file`|`tap`|`formula`|`cask` …]

Проверить соответствие формул или файлов рекомендациям по стилю Homebrew.

Списки file, tap и formula нельзя объединять. Если ничего не указано, style проверит стиль всей библиотеки Homebrew, включая основной код и все формулы.

--fix: Автоматически исправить нарушения стиля с помощью функции автоисправления RuboCop.
--todo: Добавить комментарии rubocop:todo для нарушений RuboCop, оставшихся после автоисправления. Требуется --fix.
--reset-cache: Сбросить кэш RuboCop.
--changed: Проверить файлы, изменённые относительно ветки main.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask.
--only-cops: Указать разделённый запятыми список cops, чтобы проверять нарушения только перечисленных cops RuboCop.
--except-cops: Указать разделённый запятыми список cops, чтобы пропустить проверку нарушений перечисленных cops RuboCop.

`tap-new` [`options`] `user``/``repo`

Создать файлы шаблона для нового tap.

--no-git: Не инициализировать репозиторий Git для tap.
--branch: Инициализировать репозиторий Git и настроить рабочие процессы GitHub Actions с указанным именем ветки (по умолчанию: main).
--github-packages: Загружать bottle в GitHub Packages.

`test` [`options`] `installed_formula` […]

Запустить метод тестирования, предоставленный установленной формулой. Стандартный вывод и код возврата не определены, но обычно команда должна сообщить пользователю о проблемах с установленной формулой.

Пример: brew install jruby && brew test jruby

-f, --force: Тестировать формулы, даже если они не связаны.
--HEAD: Тестировать версию формулы HEAD.
--keep-tmp: Сохранять временные файлы, созданные для теста.
--retry: Повторить попытку, если тест завершился с ошибкой.

`test-bot` [`options`] [`formula`]

Проверить полный жизненный цикл изменений Homebrew в tap (репозитории Git). Например, для pull request GitHub Actions, изменяющего формулу, brew test-bot очистит систему и подготовит её к тестированию формулы, установит формулу, выполнит различные тесты и проверки, создаст bottle (пакет) с двоичными файлами и протестирует зависящие от неё формулы, чтобы убедиться, что изменения ничего не нарушили.

Поддерживается только GitHub Actions в качестве CI-провайдера. Это связано с тем, что Homebrew использует GitHub Actions, который бесплатно доступен для публичного и частного использования с рабочими процессами на macOS и Linux.

--dry-run: Вывести план действий вместо выполнения команд.
--cleanup: Удалить всё состояние из каталога Homebrew. Используйте с осторожностью!
--skip-setup: Не проверять, правильно ли настроена локальная система.
--build-from-source: Собирать из исходного кода, а не создавать bottle.
--build-dependents-from-source: Собирать зависимые пакеты из исходного кода, а не тестировать bottle.
--junit: Создать файл результатов тестирования в формате JUnit XML.
--keep-old: Запустить brew bottle --keep-old для создания новых bottle для одной платформы.
--skip-relocation: Запустить brew bottle --skip-relocation для создания новых bottle, не требующих перемещения.
--only-json-tab: Запустить brew bottle --only-json-tab для создания новых bottle без tab.
--local: Попросить Homebrew записывать подробные журналы в ./logs/ и установить $HOME в значение ./home/.
--tap: Использовать репозиторий Git указанного tap. По умолчанию для проверки синтаксиса используется основной tap.
--fail-fast: Немедленно завершить работу при ошибке на каком-либо этапе.
-v, --verbose: Выводить результаты этапов тестирования в реальном времени. При этом вывод передаётся в виде необработанных байтов, а не перекодируется в UTF-8.
--test-default-formula: Использовать тестовую формулу по умолчанию, если сборка выполняется не для tap и другие формулы не указаны.
--root-url: Использовать указанный URL в качестве корня URL bottle вместо значения по умолчанию для Homebrew.
--git-name: Задать указанное имя автора/коммитера Git.
--git-email: Задать указанный адрес электронной почты автора/коммитера Git.
--publish: Опубликовать загруженные bottle.
--skip-online-checks: Не передавать --online в brew audit и пропустить brew livecheck.
--skip-new: Не передавать --new в brew audit для новых формул.
--skip-new-strict: Не передавать --strict в brew audit для новых формул.
--skip-dependents: Не тестировать зависимые пакеты.
--skip-livecheck: Не запускать livecheck.
--skip-recursive-dependents: Тестировать только непосредственные зависимые пакеты.
--skip-checksum-only-audit: Не проверять изменения только контрольной суммы.
--skip-stable-version-audit: Не проверять стабильную версию.
--skip-revision-audit: Не проверять ревизию.
--only-cleanup-before: Выполнить только этап очистки перед запуском. Требуется --cleanup, кроме случаев запуска в GitHub Actions.
--only-setup: Выполнить только этап проверки настройки локальной системы.
--only-tap-syntax: Выполнить только этап проверки синтаксиса tap.
--stable: Выполнить только проверки синтаксиса tap, необходимые для стабильной версии brew.
--only-formulae: Выполнить только этапы для формул.
--only-formulae-detect: Выполнить только этапы обнаружения формул.
--only-formulae-dependents: Выполнить только этапы для зависимых формул.
--only-bottles-fetch: Выполнить только этапы получения bottle. Эта необязательная проверка после загрузки проверяет, что все bottle загружены правильно. Она не запускается без запроса и нужна только на одном компьютере. Коммит bottle, который проверяется, должен находиться в тестируемой ветке.
--only-cleanup-after: Выполнить только этап очистки после завершения. Требуется --cleanup, кроме случаев запуска в GitHub Actions.
--testing-formulae: Использовать эти тестовые формулы вместо выполнения этапов обнаружения формул.
--added-formulae: Использовать эти добавленные формулы вместо выполнения этапов обнаружения формул.
--deleted-formulae: Использовать эти удалённые формулы вместо выполнения этапов обнаружения формул.
--skipped-or-failed-formulae: Использовать эти пропущенные или завершившиеся с ошибкой формулы из этапов для формул на этапе проверки зависимых формул.
--tested-formulae: Использовать эти протестированные формулы из этапов для формул на этапе проверки зависимых формул.

`tests` [`options`]

Запустить модульные и интеграционные тесты Homebrew.

--coverage: Создать отчёты о покрытии кода.
--generic: Запустить только тесты, не зависящие от операционной системы.
--online: Включить тесты, использующие API GitHub, и тесты, использующие любой из tap для официальных внешних команд.
--debug: Включить отладку с помощью ruby/debug или вывести стандартный вывод odebug.
--changed: Запускать тесты только для файлов, изменённых относительно ветки main.
--fail-fast: Завершить работу при первой ошибке теста.
--no-parallel: Запускать тесты последовательно.
--stackprof: Использовать stackprof для профилирования тестов.
--vernier: Использовать vernier для профилирования тестов.
--ruby-prof: Использовать ruby-prof для профилирования тестов.
--only: Запустить только <test_script>_spec.rb. Если добавить :<line_number>, выполнение начнётся с указанной строки.
--profile: Вывести n самых медленных тестов. Если параметр --no-parallel не указан, будут выведены самые медленные тесты для каждого параллельного процесса тестирования.
--seed: Перемешать тесты, используя указанное значение value вместо случайного начального значения.

`typecheck`, `tc` [`options`] [`tap` …]

Проверить наличие ошибок типизации с помощью Sorbet.

--fix: Автоматически исправить ошибки типизации.
-q, --quiet: Подавить все некритические ошибки.
--update: Обновить файлы RBI.
--update-all: Обновить все файлы RBI, а не только файлы обновлённых гемов.
--suggest-typed: Попробовать обновить сигилы typed.
--lsp: Запустить сервер Sorbet LSP.
--dir: Проверить типы всех файлов в указанном каталоге.
--file: Проверить типы одного файла.
--ignore: Игнорировать входные файлы, пути которых (относительно входного пути, переданного Sorbet) содержат указанную строку.

`unbottled` [`options`] [`formula` …]

Показать зависимые формулы, для которых нет bottle.

--tag: Использовать указанный тег bottle (например, big_sur) вместо текущей операционной системы.
--dependents: Не получать аналитические данные и сортировать по числу зависимых пакетов.
--total: Вывести количество формул без bottle и общее количество формул.
--lost: Вывести коммиты homebrew/core, в которых за последнюю неделю были потеряны bottle.

`unpack` [`options`] `formula`|`cask` […]

Распаковать файлы formula или cask в подкаталоги текущего рабочего каталога.

--destdir: Вместо этого создавать подкаталоги в каталоге, указанном в path.
--patch: К распакованному исходному коду будут применены патчи для formula.
-g, --git: Инициализировать репозиторий Git в распакованном исходном коде. Это полезно для создания патчей для программного обеспечения.
-f, --force: Перезаписать каталог назначения, если он уже существует.
--formula: Считать все именованные аргументы формулами.
--cask: Считать все именованные аргументы cask.

`update-perl-resources` [`--print-only`] [`--ignore-errors`] `formula` […]

Обновить версии блоков ресурсов CPAN в formula.

-p, --print-only: Вывести обновлённые блоки ресурсов, не изменяя formula.
--ignore-errors: Продолжить обработку, даже если некоторые ресурсы не удаётся разрешить.

`update-python-resources` [`options`] `formula` […]

Обновить версии блоков ресурсов PyPI в formula.

-p, --print-only: Вывести обновлённые блоки ресурсов, не изменяя formula.
--ignore-errors: Записать все обнаруженные ресурсы, включая те, которые не удалось успешно разрешить. Этот параметр игнорируется для формул homebrew/core.
--ignore-non-pypi-packages: Не завершать работу с ошибкой, если formula не является пакетом PyPI.
--install-dependencies: Установить отсутствующие зависимости, необходимые для обновления ресурсов.
--version: Использовать указанную version при поиске ресурсов для formula. Если версия не указана, будет использоваться текущая версия formula.
--package-name: Использовать указанное package-name при поиске ресурсов для formula. Если имя пакета не указано, оно будет определено по стабильному URL формулы.
--extra-packages: Включить эти дополнительные пакеты при поиске ресурсов.
--exclude-packages: Исключить эти пакеты при поиске ресурсов.

`update-test` [`options`]

Запустить тест brew update с новым клоном репозитория. Если параметры не указаны, в качестве начального коммита используется origin/main.

--to-tag: Установить $HOMEBREW_UPDATE_TO_TAG для проверки обновления между тегами.
--keep-tmp: Сохранить временный каталог с новым клоном репозитория.
--commit: Использовать указанную commit в качестве начального коммита.
--before: Использовать коммит по указанному date в качестве начального коммита.

`vendor-gems` [`--update=`] [`--no-commit`]

Установить и зафиксировать поставляемые вместе с Homebrew гемы.

--update: Обновить указанный список поставляемых гемов до последних версий.
--no-commit: Не создавать новый коммит после завершения.

`verify` [`options`] `formula` […]

Проверить происхождение сборок bottle с помощью инструментов аттестации GitHub. Для этого сначала загружаются указанные bottle, а затем проверяется их происхождение.

Обратите внимание: эта команда зависит от GitHub CLI. Запустите brew install gh.

--os: Загрузить для указанной операционной системы. (Передайте all, чтобы загрузить для всех операционных систем.)
--arch: Загрузить для указанной архитектуры ЦП. (Передайте all, чтобы загрузить для всех архитектур.)
--bottle-tag: Загрузить bottle для указанного тега.
--deps: Также загрузить зависимости для всех перечисленных formula.
-f, --force: Удалить ранее кэшированную версию и загрузить её заново.
-j, --json: Возвращать данные attestation в формате JSON для каждого bottle.

`which-update` [`options`] `database`

Обновление базы данных для brew which-formula.

--bottle-json-dir: Использовать сгенерированные JSON-файлы bottle из указанного каталога для обновления записей формул.
--removed-formulae-file: Удалить записи базы данных для формул, перечисленных в указанном файле.
--pull-request: Обновить записи, соответствующие изменениям формул в указанном номере запроса на слияние.
--repository: Репозиторий GitHub для --pull-request (по умолчанию: $GITHUB_REPOSITORY).
--summary-file: Вывести сводку изменений в файл.

ГЛОБАЛЬНЫЕ ПАРАМЕТРЫ CASK

Эти параметры применимы к подкомандам install, reinstall и upgrade с переключателем --cask.

--appdir: Целевое расположение приложений (по умолчанию: /Applications).
--appimagedir: Целевое расположение AppImage (по умолчанию: ~/Applications).
--keyboard-layoutdir: Целевое расположение раскладок клавиатуры (по умолчанию: /Library/Keyboard Layouts).
--colorpickerdir: Целевое расположение палитр цветов (по умолчанию: ~/Library/ColorPickers).
--prefpanedir: Целевое расположение панелей настроек (по умолчанию: ~/Library/PreferencePanes).
--qlplugindir: Целевое расположение плагинов Quick Look (по умолчанию: ~/Library/QuickLook).
--mdimporterdir: Целевое расположение плагинов Spotlight (по умолчанию: ~/Library/Spotlight).
--dictionarydir: Целевое расположение словарей (по умолчанию: ~/Library/Dictionaries).
--fontdir: Целевое расположение шрифтов (по умолчанию: ~/Library/Fonts).
--servicedir: Целевое расположение служб (по умолчанию: ~/Library/Services).
--input-methoddir: Целевое расположение методов ввода (по умолчанию: ~/Library/Input Methods).
--internet-plugindir: Целевое расположение интернет-плагинов (по умолчанию: ~/Library/Internet Plug-Ins).
--audio-unit-plugindir: Целевое расположение плагинов Audio Unit (по умолчанию: ~/Library/Audio/Plug-Ins/Components).
--vst-plugindir: Целевое расположение плагинов VST (по умолчанию: ~/Library/Audio/Plug-Ins/VST).
--vst3-plugindir: Целевое расположение плагинов VST3 (по умолчанию: ~/Library/Audio/Plug-Ins/VST3).
--screen-saverdir: Целевое расположение заставок (по умолчанию: ~/Library/Screen Savers).
--language: Разделённый запятыми список кодов языков, предпочтительных для установки cask. Используется первый подходящий язык; если подходящего языка нет, выбирается язык cask по умолчанию. По умолчанию используется язык вашей системы.

ГЛОБАЛЬНЫЕ ПАРАМЕТРЫ

Эти параметры применимы к нескольким подкомандам.

-d, --debug: Показывать отладочную информацию.
-q, --quiet: Сделать вывод менее подробным.
-v, --verbose: Сделать вывод более подробным.
-h, --help: Показать это сообщение.

ПОЛЬЗОВАТЕЛЬСКИЕ ВНЕШНИЕ КОМАНДЫ

Homebrew, как и git(1), поддерживает внешние команды. Это исполняемые скрипты, которые находятся где-либо в $PATH и называются brew-cmdname или brew-cmdname.rb; их можно вызывать как brew cmdname. Это позволяет создавать собственные команды, не изменяя внутренние компоненты Homebrew.

Инструкции по созданию собственных команд приведены в документации: https://docs.brew.sh/External-Commands

УКАЗАНИЕ ФОРМУЛ

Многие команды Homebrew принимают один или несколько аргументов formula. Эти аргументы могут задаваться в нескольких формах:

Имя формулы: например, git, node, wget.
Полное имя формулы из подключённого репозитория: иногда формула из подключённого репозитория может конфликтовать с формулой в homebrew/core. Такие формулы всё равно можно использовать, указав специальный синтаксис, например homebrew/dupes/vim или homebrew/versions/node4.

УКАЗАНИЕ CASK

Многие команды Homebrew Cask принимают один или несколько аргументов cask. Их можно указывать так же, как аргументы formula, описанные выше в разделе SPECIFYING FORMULAE.

ОКРУЖЕНИЕ

Обратите внимание: чтобы переменные окружения обнаруживались, им должно быть присвоено значение. Например, выполните export HOMEBREW_NO_INSECURE_REDIRECT=1, а не просто export HOMEBREW_NO_INSECURE_REDIRECT.

Переменные окружения HOMEBREW_* также можно задавать в файлах окружения Homebrew:

/etc/homebrew/brew.env (для всей системы)
${HOMEBREW_PREFIX}/etc/homebrew/brew.env (для конкретного префикса)
$XDG_CONFIG_HOME/homebrew/brew.env, если задано $XDG_CONFIG_HOME, или ~/.homebrew/brew.env в противном случае (для конкретного пользователя)

Пользовательские файлы окружения имеют приоритет над файлами для конкретного префикса, а файлы для конкретного префикса — над системными (если не задано $HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY; см. ниже).

Обратите внимание: эти файлы не поддерживают подстановку переменных оболочки (например, $HOME) и выполнение команд (например, $(cat file)).

HOMEBREW_ALLOWED_TAPS

Список tap, разделённых пробелами. Homebrew откажется устанавливать формулу, если она и все её зависимости не находятся в официальном tap или в tap из этого списка. Каждая запись — это имя user/repository (соответствующее только tap, использующим удалённый репозиторий GitHub по умолчанию) или URL удалённого репозитория (необходимый для соответствия tap с пользовательским удалённым репозиторием).

HOMEBREW_API_AUTO_UPDATE_SECS

Проверять API Homebrew на наличие новых формул или данных cask каждые $HOMEBREW_API_AUTO_UPDATE_SECS секунд. Кроме того, можно полностью отключить автоматическую проверку обновлений API с помощью $HOMEBREW_NO_AUTO_UPDATE.

По умолчанию: 450.

HOMEBREW_API_DOMAIN

Использовать этот URL в качестве зеркала загрузки для JSON API Homebrew. Если файлы метаданных по этому URL временно недоступны, резервным зеркалом станет домен API по умолчанию.

По умолчанию: https://formulae.brew.sh/api.

HOMEBREW_ARCH

Только Linux: передать это значение в качестве имени типа, представляющего параметр компилятора -march.

По умолчанию: native.

HOMEBREW_ARTIFACT_DOMAIN

Добавлять это значение в начало всех URL загрузки, включая URL бутылок. Например, export HOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080 приведёт к тому, что формула с URL https://example.com/foo.tar.gz будет загружаться вместо этого с http://localhost:8080/https://example.com/foo.tar.gz. Однако для URL бутылок домен заменяется этим префиксом. В результате, например, https://ghcr.io/v2/homebrew/core/gettext/manifests/0.21 будет загружаться вместо этого с http://localhost:8080/v2/homebrew/core/gettext/manifests/0.21

HOMEBREW_ARTIFACT_DOMAIN_NO_FALLBACK

Если заданы одновременно $HOMEBREW_ARTIFACT_DOMAIN и $HOMEBREW_ARTIFACT_DOMAIN_NO_FALLBACK, то в случае сбоя запроса к $HOMEBREW_ARTIFACT_DOMAIN Homebrew выдаст ошибку, а не станет пробовать другие URL или URL по умолчанию.

HOMEBREW_AUTO_UPDATE_SECS

Выполнять brew update раз в $HOMEBREW_AUTO_UPDATE_SECS секунд перед некоторыми командами, например brew install, brew upgrade или brew tap. Кроме того, можно полностью отключить автоматическое обновление с помощью $HOMEBREW_NO_AUTO_UPDATE.

По умолчанию: 86400 (24 часа), 3600 (1 час), если выполнялась команда для разработчиков, или 300 (5 минут), если задано $HOMEBREW_NO_INSTALL_FROM_API.

HOMEBREW_AVOID_NESTED_SANDBOXING

Если задано, Homebrew пропускает свою песочницу, когда сам выполняется внутри другой песочницы от имени непривилегированного пользователя вне префикса по умолчанию. При этом вместо запрета сетевого доступа и доступа к файловой системе во время сборки Homebrew полагается на внешнюю песочницу. Homebrew выдаёт ошибку, если префикс или группа не позволяют пропустить песочницу.

HOMEBREW_BAT

Если задано, использовать bat для команды brew cat.

HOMEBREW_BAT_CONFIG_PATH

Использовать этот файл конфигурации bat.

По умолчанию: $BAT_CONFIG_PATH.

HOMEBREW_BAT_THEME

Использовать эту тему bat для подсветки синтаксиса.

По умолчанию: $BAT_THEME.

HOMEBREW_BOTTLE_DOMAIN

Использовать этот URL в качестве зеркала загрузки бутылок. Если бутылки по этому URL временно недоступны, резервным зеркалом станет домен бутылок по умолчанию. Например, export HOMEBREW_BOTTLE_DOMAIN=http://localhost:8080 приведёт к тому, что все бутылки будут загружаться с префикса http://localhost:8080/. Если бутылки недоступны по адресу $HOMEBREW_BOTTLE_DOMAIN, они будут загружены с домена бутылок по умолчанию.

По умолчанию: https://ghcr.io/v2/homebrew/core.

HOMEBREW_BREW_GIT_REMOTE

Использовать этот URL в качестве удалённого репозитория git(1) Homebrew/brew.

По умолчанию: https://github.com/Homebrew/brew.

HOMEBREW_BROWSER

Использовать это приложение в качестве браузера при открытии домашних страниц проектов.

По умолчанию: $BROWSER или браузер ОС по умолчанию.

HOMEBREW_BUNDLE_CLEANUP_NO_BREW

Если задано, brew bundle cleanup не будет очищать зависимости формул.

HOMEBREW_BUNDLE_CLEANUP_NO_CARGO

Если задано, brew bundle cleanup не будет очищать пакеты Cargo.

HOMEBREW_BUNDLE_CLEANUP_NO_CASK

Если задано, brew bundle cleanup не будет очищать зависимости cask.

HOMEBREW_BUNDLE_CLEANUP_NO_FLATPAK

Если задано, brew bundle cleanup не будет очищать пакеты Flatpak.

HOMEBREW_BUNDLE_CLEANUP_NO_GO

Если задано, brew bundle cleanup не будет очищать пакеты Go.

HOMEBREW_BUNDLE_CLEANUP_NO_KREW

Если задано, brew bundle cleanup не будет очищать плагины Krew.

HOMEBREW_BUNDLE_CLEANUP_NO_MAS

Если задано, brew bundle cleanup не будет очищать зависимости Mac App Store.

HOMEBREW_BUNDLE_CLEANUP_NO_NPM

Если задано, brew bundle cleanup не будет очищать пакеты npm.

HOMEBREW_BUNDLE_CLEANUP_NO_TAP

Если задано, brew bundle cleanup не будет очищать зависимости tap.

HOMEBREW_BUNDLE_CLEANUP_NO_UV

Если задано, brew bundle cleanup не будет очищать инструменты uv.

HOMEBREW_BUNDLE_CLEANUP_NO_VSCODE

Если задано, brew bundle cleanup не будет очищать расширения VSCode (а также форков и вариантов).

HOMEBREW_BUNDLE_CLEANUP_NO_WINGET

Если задано, brew bundle cleanup не будет очищать пакеты WinGet.

HOMEBREW_BUNDLE_DUMP_NO_BREW

Если задано, brew bundle dump не будет выгружать зависимости формул.

HOMEBREW_BUNDLE_DUMP_NO_CARGO

Если задано, brew bundle dump не будет выгружать пакеты Cargo.

HOMEBREW_BUNDLE_DUMP_NO_CASK

Если задано, brew bundle dump не будет выгружать зависимости cask.

HOMEBREW_BUNDLE_DUMP_NO_FLATPAK

Если задано, brew bundle dump не будет выгружать пакеты Flatpak.

HOMEBREW_BUNDLE_DUMP_NO_GO

Если задано, brew bundle dump не будет выгружать пакеты Go.

HOMEBREW_BUNDLE_DUMP_NO_KREW

Если задано, brew bundle dump не будет выгружать плагины Krew.

HOMEBREW_BUNDLE_DUMP_NO_MAS

Если задано, brew bundle dump не будет выгружать зависимости Mac App Store.

HOMEBREW_BUNDLE_DUMP_NO_NPM

Если задано, brew bundle dump не будет выгружать пакеты npm.

HOMEBREW_BUNDLE_DUMP_NO_TAP

Если задано, brew bundle dump не будет выгружать зависимости tap.

HOMEBREW_BUNDLE_DUMP_NO_UV

Если задано, brew bundle dump не будет выгружать инструменты uv.

HOMEBREW_BUNDLE_DUMP_NO_VSCODE

Если задано, brew bundle dump не будет выгружать расширения VSCode (а также форков и вариантов).

HOMEBREW_BUNDLE_DUMP_NO_WINGET

Если задано, brew bundle dump не будет выгружать пакеты WinGet.

HOMEBREW_BUNDLE_FORCE_INSTALL_CLEANUP

Если задано, запускать brew bundle cleanup --force после brew bundle install.

HOMEBREW_BUNDLE_JOBS

Использовать это значение как число параллельно выполняемых установок формул для brew bundle install. Используйте auto, чтобы задать число ядер процессора (не более 4).

По умолчанию: auto.

HOMEBREW_BUNDLE_NO_DESCRIBE

Если задано, не включать комментарии с описанием пакетов из $HOMEBREW_BUNDLE_DESCRIBE или значения по умолчанию. Это не отключает явно заданное --describe.

HOMEBREW_BUNDLE_NO_JOBS

Если задано, не включать параллельные задачи из $HOMEBREW_BUNDLE_JOBS или его значения по умолчанию. Это не отключает явно заданное --jobs.

HOMEBREW_BUNDLE_SECRETS

Если задано, не включать очистку секретов по умолчанию. Это не отключает явно заданное --no-secrets.

HOMEBREW_BUNDLE_USER_CACHE

Если задано, использовать этот каталог в качестве пользовательского кэша bundle(1).

HOMEBREW_CACHE

Использовать этот каталог в качестве кэша загрузок.

По умолчанию: macOS: ~/Library/Caches/Homebrew, Linux: $XDG_CACHE_HOME/Homebrew или ~/.cache/Homebrew.

HOMEBREW_CASK_OPTS

Добавлять эти параметры ко всем командам cask. Поддерживаются все параметры --*dir, --language, --require-sha и --no-binaries. Например, можно добавить что-то вроде следующего в ~/.profile, ~/.bash_profile или ~/.zshenv:

export HOMEBREW_CASK_OPTS="--appdir=${HOME}/Applications --fontdir=/Library/Fonts"

HOMEBREW_CLEANUP_MAX_AGE_DAYS

Очищать все кэшированные файлы, возраст которых превышает указанное число дней.

По умолчанию: 120.

HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS

Если задано, brew install, brew upgrade и brew reinstall будут очищать все формулы по истечении указанного числа дней.

По умолчанию: 30.

HOMEBREW_COLOR

Если задано, принудительно использовать цветной вывод для потоков, не связанных с TTY.

HOMEBREW_CORE_GIT_REMOTE

Использовать этот URL в качестве удалённого репозитория git(1) Homebrew/homebrew-core.

По умолчанию: https://github.com/Homebrew/homebrew-core.

HOMEBREW_CURLRC

Если задан абсолютный путь (то есть начинающийся с /), передавать его с помощью --config при вызове curl(1). Если значение задано, но не является допустимым путём, не передавать --disable, что отключает использование .curlrc.

HOMEBREW_CURL_PATH

Только Linux: задать достаточно новую исполняемую программу curl для использования Homebrew.

По умолчанию: curl.

HOMEBREW_CURL_RETRIES

Передавать указанное число повторных попыток в --retry при вызове curl(1).

По умолчанию: 3.

HOMEBREW_CURL_VERBOSE

Если задано, передавать --verbose при вызове curl(1).

HOMEBREW_DEBUG

Если задано, всегда считать, что при выполнении команд задано --debug.

HOMEBREW_DEVELOPER

Если задано, изменять поведение так, чтобы оно было более подходящим для разработчиков Homebrew (действующих или начинающих), например превращать предупреждения в ошибки.

HOMEBREW_DISABLE_DEBREW

Если задано, интерактивный отладчик формул, доступный через --debug, будет отключён.

HOMEBREW_DISABLE_LOAD_FORMULA

Если задано, отказываться загружать формулы. Это полезно, если формулы не вызывают доверия (например, в запросах на включение изменений).

HOMEBREW_DISPLAY

Использовать этот дисплей X11 при открытии страницы в браузере, например с помощью brew home. В первую очередь полезно в Linux.

По умолчанию: $DISPLAY.

HOMEBREW_DISPLAY_INSTALL_TIMES

Если задано, в конце выполнения выводить время установки каждой формулы.

HOMEBREW_DOCKER_REGISTRY_BASIC_AUTH_TOKEN

Использовать это имя пользователя и пароль в кодировке base64 для аутентификации в реестре Docker, проксирующем GitHub Packages. Если задано none, заголовок аутентификации отправляться не будет. Это можно использовать, если удалённый $HOMEBREW_BOTTLE_DOMAIN не поддерживает аутентификацию. Если задано $HOMEBREW_DOCKER_REGISTRY_TOKEN, вместо этого будет использоваться оно.

HOMEBREW_DOCKER_REGISTRY_TOKEN

Использовать этот токен доступа типа Bearer для аутентификации в реестре Docker, проксирующем GitHub Packages. Имеет приоритет над $HOMEBREW_DOCKER_REGISTRY_BASIC_AUTH_TOKEN.

HOMEBREW_DOWNLOAD_CONCURRENCY

Homebrew будет выполнять загрузки параллельно, используя указанное число одновременных подключений. Значение по умолчанию, auto, означает, что будет использоваться вдвое больше подключений, чем доступно ядер процессора (согласно нашим тестам, это обеспечивает наилучшую производительность). Если задано 1, Homebrew будет загружать файлы последовательно.

По умолчанию: auto.

HOMEBREW_EDITOR

Использовать этот редактор при редактировании одной формулы или нескольких формул в одном каталоге.

Примечание: brew edit откроет весь Homebrew как набор разрозненных файлов и каталогов. Visual Studio Code корректно обрабатывает такой набор в режиме проекта, однако многие редакторы в этом случае могут работать странным образом.

По умолчанию: $EDITOR или $VISUAL.

HOMEBREW_ENV_SYNC_STRICT

Если задано, brew *env-sync будет синхронизировать только точные установленные версии формул.

HOMEBREW_FAIL_LOG_LINES

Выводить указанное число строк при сбоях system формулы.

По умолчанию: 15.

HOMEBREW_FORBIDDEN_CASKS

Список cask, разделённых пробелами. Homebrew откажется устанавливать cask, если он или любая из его зависимостей входит в этот список.

HOMEBREW_FORBIDDEN_CASK_ARTIFACTS

Список типов артефактов cask, разделённых пробелами (например, pkg installer), которые запрещено устанавливать в составе cask. Допустимые значения: pkg, installer, binary, uninstall, zap, app, suite, artifact, prefpane, qlplugin, dictionary, font, service, colorpicker, inputmethod, internetplugin, audiounitplugin, vstplugin, vst3plugin, screensaver, keyboardlayout, mdimporter, preflight, postflight, manpage, bashcompletion, fishcompletion, zshcompletion, stageonly.

HOMEBREW_FORBIDDEN_FORMULAE

Список формул, разделённых пробелами. Homebrew откажется устанавливать формулу или cask, если они либо какая-либо из их зависимостей входят в этот список.

HOMEBREW_FORBIDDEN_LICENSES

Список идентификаторов лицензий SPDX, разделённых пробелами. Homebrew откажется устанавливать формулу, если у неё или любой из её зависимостей лицензия входит в этот список.

HOMEBREW_FORBIDDEN_OWNER

Лицо, задавшее любые переменные $HOMEBREW_FORBIDDEN_*.

По умолчанию: you.

HOMEBREW_FORBIDDEN_OWNER_CONTACT

Способ связаться с $HOMEBREW_FORBIDDEN_OWNER, если он задан и это необходимо.

HOMEBREW_FORBIDDEN_TAPS

Список tap, разделённых пробелами. Homebrew откажется устанавливать формулу, если она или любая из её зависимостей находится в tap из этого списка. Каждая запись — это имя user/repository (соответствующее только tap, использующим удалённый репозиторий GitHub по умолчанию) или URL удалённого репозитория (необходимый для соответствия tap с пользовательским удалённым репозиторием).

HOMEBREW_FORBID_CASKS

Если задано, Homebrew откажется устанавливать любые cask.

HOMEBREW_FORBID_PACKAGES_FROM_PATHS

Если задано, Homebrew откажется читать формулы или cask, указанные по путям к файлам, например brew install ./package.rb.

По умолчанию: true, если не задано $HOMEBREW_DEVELOPER.

HOMEBREW_FORCE_API_AUTO_UPDATE

Если задано, обновлять данные формул или cask в API Homebrew, даже если задано $HOMEBREW_NO_AUTO_UPDATE.

HOMEBREW_FORCE_BREWED_CA_CERTIFICATES

Если задано, всегда использовать установленный Homebrew ca-certificates вместо системной версии. Задаётся автоматически, если системная версия слишком старая.

HOMEBREW_FORCE_BREWED_CURL

Если задано, всегда использовать установленный Homebrew curl(1) вместо системной версии. Задаётся автоматически, если системная версия curl слишком старая.

HOMEBREW_FORCE_BREWED_GIT

Если задано, всегда использовать установленный Homebrew git(1) вместо системной версии. Задаётся автоматически, если системная версия git слишком старая.

HOMEBREW_FORCE_BREW_WRAPPER

Если задано, требовать, чтобы для нетривиальных команд brew вызов brew выполнялся от имени пользователя, указанного в $HOMEBREW_FORCE_BREW_WRAPPER.

HOMEBREW_FORCE_BREW_WRAPPER_HELP_MESSAGE

Если задано, добавлять это значение к сообщению об ошибке $HOMEBREW_FORCE_BREW_WRAPPER, чтобы предоставить пользователю дополнительную справку или контекст.

HOMEBREW_FORCE_VENDOR_RUBY

Если задано, всегда использовать поставляемую с Homebrew переносимую версию Ruby, даже если системная версия Ruby достаточно новая.

HOMEBREW_FORMULA_BUILD_NETWORK

Если задано, управляет сетевым доступом песочницы при сборке формул. Переопределяет любые настройки, заданные с помощью DSL внутри формул. Допустимые значения: allow или deny. Если значение не задано ни этой переменной среды, ни с помощью DSL, по умолчанию используется поведение allow.

HOMEBREW_FORMULA_POSTINSTALL_NETWORK

Если задано, управляет сетевым доступом песочницы при выполнении postinstall формул. Переопределяет любые настройки, заданные с помощью DSL внутри формул. Допустимые значения: allow или deny. Если значение не задано ни этой переменной среды, ни с помощью DSL, по умолчанию используется поведение allow.

HOMEBREW_FORMULA_TEST_NETWORK

Если задано, управляет сетевым доступом песочницы при тестировании формул. Переопределяет любые настройки, заданные с помощью DSL внутри формул. Допустимые значения: allow или deny. Если значение не задано ни этой переменной среды, ни с помощью DSL, по умолчанию используется поведение allow.

HOMEBREW_GITHUB_API_TOKEN

Использовать этот персональный токен доступа для API GitHub, например для функций вроде brew search. Создать токен можно на странице https://github.com/settings/tokens. При наличии токена GitHub разрешит выполнять больше запросов к API. Дополнительную информацию см. на странице: https://docs.github.com/en/rest/overview/rate-limits-for-the-rest-api

Примечание: Homebrew не требует разрешений ни для одной из областей доступа, однако некоторым командам для разработчиков могут потребоваться дополнительные разрешения.

HOMEBREW_GITHUB_PACKAGES_TOKEN

Использовать этот персональный токен доступа GitHub при обращении к реестру GitHub Packages (где могут храниться бутылки).

HOMEBREW_GITHUB_PACKAGES_USER

Использовать это имя пользователя при обращении к реестру GitHub Packages (где могут храниться бутылки).

HOMEBREW_GIT_COMMITTER_EMAIL

Установить для адреса электронной почты коммиттера Git это значение.

HOMEBREW_GIT_COMMITTER_NAME

Установить для имени коммиттера Git это значение.

HOMEBREW_GIT_EMAIL

Установить для имени автора Git и, если $HOMEBREW_GIT_COMMITTER_EMAIL не задано, для адреса электронной почты коммиттера это значение.

HOMEBREW_GIT_NAME

Установить для имени автора Git и, если $HOMEBREW_GIT_COMMITTER_NAME не задано, для имени коммиттера это значение.

HOMEBREW_GIT_PATH

Только Linux: задать достаточно новую исполняемую программу git для использования Homebrew.

По умолчанию: git.

HOMEBREW_INSTALL_BADGE

Выводить этот текст перед сводкой установки каждой успешно собранной формулы.

По умолчанию: эмодзи «Кружка пива».

HOMEBREW_LIVECHECK_AUTOBUMP

Если задано, brew livecheck будет включать данные о пакетах, автоматически обновлённых BrewTestBot.

HOMEBREW_LIVECHECK_WATCHLIST

Использовать этот файл со списком формул, которые нужно проверять по умолчанию, если команде brew livecheck не передан аргумент с формулой.

По умолчанию: ${XDG_CONFIG_HOME}/homebrew/livecheck_watchlist.txt, если задано $XDG_CONFIG_HOME, или ~/.homebrew/livecheck_watchlist.txt в противном случае.

HOMEBREW_LOCK_CONTEXT

Если задано, Homebrew будет добавлять этот вывод в качестве дополнительного контекста к ошибкам блокировки. Это полезно при запуске brew в фоновом режиме.

HOMEBREW_LOGS

Использовать этот каталог для хранения файлов журналов.

По умолчанию: macOS: ~/Library/Logs/Homebrew, Linux: ${XDG_CACHE_HOME}/Homebrew/Logs или ~/.cache/Homebrew/Logs.

HOMEBREW_MAKE_JOBS

Использовать это значение как число параллельных задач при сборке с помощью make(1).

По умолчанию: число доступных ядер процессора.

HOMEBREW_NO_ANALYTICS

Если задано, не отправлять аналитические данные. Google Analytics больше не работает. Дополнительную информацию см. на странице: https://docs.brew.sh/Analytics

HOMEBREW_NO_ASK

Если задано, не включать режим подтверждения по умолчанию. Это не отключает явно заданное --ask.

HOMEBREW_NO_AUTOREMOVE

Если задано, вызовы brew cleanup и brew uninstall не будут автоматически удалять неиспользуемые зависимости формул.

HOMEBREW_NO_AUTO_UPDATE

Если задано, не выполнять автоматическое обновление перед некоторыми командами, например brew install, brew upgrade или brew tap. Рекомендуется запускать обновление реже, установив для $HOMEBREW_AUTO_UPDATE_SECS значение выше значения по умолчанию. Обратите внимание: эта настройка в сочетании, например, с добавлением новых tap может привести к некорректной конфигурации. Перед отправкой сообщения о проблеме обязательно запускайте brew update.

HOMEBREW_NO_BOOTSNAP

Если задано, не использовать Bootsnap для ускорения повторных вызовов brew.

HOMEBREW_NO_CLEANUP_FORMULAE

Список формул, разделённых запятыми. Homebrew откажется очищать формулу или автоматически удалять её, если она указана в этом списке.

HOMEBREW_NO_COLOR

Если задано, не выводить цветной текст.

По умолчанию: $NO_COLOR.

HOMEBREW_NO_EMOJI

Если задано, не выводить $HOMEBREW_INSTALL_BADGE при успешной сборке.

HOMEBREW_NO_ENV_HINTS

Если задано, не выводить подсказки об изменении поведения Homebrew с помощью переменных среды.

HOMEBREW_NO_FORCE_BREW_WRAPPER

Deprecated: Если задано, отключает поведение $HOMEBREW_FORCE_BREW_WRAPPER, даже если оно задано.

HOMEBREW_NO_GITHUB_API

Если задано, не использовать API GitHub, например для поиска или получения относящихся к делу проблем после неудачной установки.

HOMEBREW_NO_INSECURE_REDIRECT

Если задано, запрещать перенаправления с защищённого HTTPS на незащищённый HTTP.

Примечание: хотя эта настройка обеспечивает полную безопасность загрузок, из-за неё загрузка исходных файлов некоторых формул, размещённых на SourceForge, GNU или GNOME, может завершаться с ошибкой.

HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK

Если задано, после установки, обновления или переустановки формул не проверять их зависимости на нарушение связей или наличие устаревших версий. Это приведёт к тому, что обновляться или переустанавливаться будет меньше зависимых пакетов (и их зависимостей), но может увеличить вероятность проблем при запуске brew install formula или brew upgrade formula.

HOMEBREW_NO_INSTALL_CLEANUP

Если задано, brew install, brew upgrade и brew reinstall никогда не будут автоматически очищать установленные, обновлённые или переустановленные формулы, а также все формулы по истечении каждых $HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS дней. Кроме того, $HOMEBREW_NO_CLEANUP_FORMULAE позволяет указать отдельные формулы, которые не следует очищать.

HOMEBREW_NO_INSTALL_FROM_API

Если задано, устанавливать формулы и cask из tap homebrew/core и homebrew/cask не через API Homebrew, а из локальных копий этих репозиториев (больших и медленных).

HOMEBREW_NO_INSTALL_UPGRADE

Если задано, brew install formula|cask не будет обновлять formula|cask, если он установлен, но устарел.

HOMEBREW_NO_PATH_SHADOW_CHECK

Если задано, brew info и brew install не будут предупреждать о том, что исполняемые файлы формулы перекрываются другими командами, расположенными раньше в $PATH.

HOMEBREW_NO_REQUIRE_TAP_TRUST

Если задано, не требовать доверия к формулам, cask и командам из неофициальных tap. Это не рекомендуется и будет удалено в одном из следующих выпусков. Также включает команды, выполняющие все формулы и cask.

HOMEBREW_NO_SANDBOX_LINUX

Если задано, отключить песочницу Linux.

HOMEBREW_NO_UPDATE_REPORT_NEW

Если задано, brew update не будет показывать список недавно добавленных формул и cask.

HOMEBREW_NO_UPGRADE_AUTO_UPDATES_CASKS

Если задано, brew upgrade не будет автоматически обновлять cask с помощью auto_updates true. Не влияет на обновления --greedy или --greedy-auto-updates.

HOMEBREW_NO_UPGRADE_QUIT_CASKS

Если задано, brew upgrade не будет закрывать запущенные приложения при обновлении cask.

HOMEBREW_NO_VERIFY_ATTESTATIONS

Если задано, Homebrew не будет проверять криптографические аттестации происхождения сборок бутылок из homebrew-core.

HOMEBREW_PIP_INDEX_URL

Если задано, brew install formula будет использовать этот URL для загрузки ресурсов пакетов PyPI.

По умолчанию: https://pypi.org/simple.

HOMEBREW_PRY

Если задано, использовать Pry для команды brew irb.

HOMEBREW_REQUIRE_TAP_TRUST

Если задано, требовать, чтобы формулы, cask и команды из неофициальных tap были проверены с помощью brew trust до того, как Homebrew загрузит их. Это поведение используется по умолчанию, если не задано $HOMEBREW_NO_REQUIRE_TAP_TRUST. Также включает команды, выполняющие все формулы и cask.

По умолчанию: true.

HOMEBREW_SBOM

Если задано, Homebrew будет записывать файлы SBOM и выполнять логику установки, связанную с SBOM.

HOMEBREW_SIMULATE_MACOS_ON_LINUX

Если задано, при запуске Homebrew в Linux будут моделироваться некоторые пути выполнения кода macOS. Это полезно для аудита формул macOS в Linux.

HOMEBREW_SKIP_OR_LATER_BOTTLES

Если задано вместе с $HOMEBREW_DEVELOPER, не использовать бутылки от более старых версий macOS. Это полезно при разработке для новых версий macOS.

HOMEBREW_SORBET_RECURSIVE

Если задано вместе с $HOMEBREW_SORBET_RUNTIME, включить рекурсивную проверку типов с помощью Sorbet. Автоматически включается при запуске brew tests.

HOMEBREW_SORBET_RUNTIME

Если задано, включить проверку типов во время выполнения с помощью Sorbet. По умолчанию задаётся при запуске brew test, brew test-bot или brew tests.

HOMEBREW_SSH_CONFIG_PATH

Если задано, при получении репозиториев Git по SSH Homebrew будет использовать указанный файл конфигурации вместо ~/.ssh/config.

По умолчанию: ~/.ssh/config

HOMEBREW_SUDO_THROUGH_SUDO_USER

Если задано, Homebrew будет использовать переменную среды $SUDO_USER для определения пользователя, от имени которого выполняется sudo(8) при запуске sudo(8).

HOMEBREW_SVN

Использовать в качестве исполняемого файла svn(1).

По умолчанию: Subversion, собранный Homebrew (если установлен), или исполняемый файл, предоставляемый системой.

HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY

Если задано в общесистемном файле среды Homebrew (/etc/homebrew/brew.env), общесистемный файл среды будет загружен последним, чтобы переопределить любые настройки префикса или пользователя.

HOMEBREW_TEMP

Использовать этот путь в качестве временного каталога для сборки пакетов. Это может потребоваться, если временный каталог системы и префикс Homebrew находятся на разных томах: macOS может испытывать затруднения при перемещении символических ссылок между томами, если целевой объект ещё не существует. Обычно эта проблема возникает при использовании FileVault или нестандартной конфигурации SSD.

По умолчанию: macOS: /private/tmp, Linux: /var/tmp.

HOMEBREW_UPDATE_TO_TAG

Если задано, всегда использовать последний стабильный тег (даже если выполнялись команды для разработчиков).

HOMEBREW_UPGRADE_GREEDY

Если задано, передавать --greedy всем командам обновления cask.

HOMEBREW_UPGRADE_GREEDY_CASKS

Список cask, разделённых пробелами. При обновлении любого cask из этого списка Homebrew будет действовать так, как если бы был передан параметр --greedy.

HOMEBREW_VERBOSE

Если задано, всегда считать, что при выполнении команд задано --verbose.

HOMEBREW_VERBOSE_USING_DOTS

Если задано, подробный вывод будет печатать . не чаще одного раза в минуту. Это может помочь избежать завершения длительных команд Homebrew из-за отсутствия вывода.

HOMEBREW_VERIFY_ATTESTATIONS

Если задано, Homebrew будет использовать инструмент gh для проверки криптографических аттестаций происхождения сборок бутылок из homebrew-core.

SUDO_ASKPASS

Если задано, передавать параметр -A при вызове sudo(8).

all_proxy

Использовать этот прокси SOCKS5 для curl(1), git(1) и svn(1) при загрузке через Homebrew.

ftp_proxy

Использовать этот прокси FTP для curl(1), git(1) и svn(1) при загрузке через Homebrew.

http_proxy

Использовать этот прокси HTTP для curl(1), git(1) и svn(1) при загрузке через Homebrew.

https_proxy

Использовать этот прокси HTTPS для curl(1), git(1) и svn(1) при загрузке через Homebrew.

no_proxy

Список имён узлов и доменных имён, разделённых запятыми, для которых не используется прокси curl(1), git(1) и svn(1) при загрузке через Homebrew.

ИСПОЛЬЗОВАНИЕ HOMEBREW ЗА ПРОКСИ-СЕРВЕРОМ

Задайте переменные среды http_proxy, https_proxy, all_proxy, ftp_proxy и/или no_proxy, описанные выше.

Например, чтобы использовать HTTP-прокси или прокси SOCKS5 без аутентификации:

export http_proxy=http://$HOST:$PORT

export all_proxy=socks5://$HOST:$PORT

А для HTTP-прокси с аутентификацией:

export http_proxy=http://$USER:$PASSWORD@$HOST:$PORT

СМ. ТАКЖЕ

Документация Homebrew: https://docs.brew.sh

API Homebrew: https://docs.brew.sh/rubydoc/

git(1), git-log(1)

АВТОРЫ

Руководитель проекта Homebrew — Mike McQuaid.

Ведущие сопровождающие Homebrew: Bevan Kay, Bo Anderson, Branch Vincent, Carlo Cabrera, Dustin Rodrigues, FX Coudert, Issy Long, Justin Krehel, Michael Cho, Michka Popoff, Mike McQuaid, Nanda H Krishna, Patrick Linnane, Rui Chen, Ruoyu Zhong, Sam Ford, Sean Molenaar и Thierry Moisan.

Другие сопровождающие Homebrew: Anton Melnikov, Caleb Xu, Daeho Ro, Douglas Eichelberger, Eric Knibbe, Klaus Hipp, Markus Reiter, Rylan Polster, Štefan Baebler и William Woodruff.

ОШИБКИ

См. наши задачи на GitHub:

Homebrew/brew: https://github.com/Homebrew/brew/issues
Homebrew/homebrew-core: https://github.com/Homebrew/homebrew-core/issues
Homebrew/homebrew-cask: https://github.com/Homebrew/homebrew-cask/issues

brew(1) — Недостающий пакетный менеджер для macOS (или Linux)

КРАТКОЕ ОПИСАНИЕ

ОПИСАНИЕ

ТЕРМИНОЛОГИЯ

ОСНОВНЫЕ КОМАНДЫ

install formula

uninstall formula

list

search [text|/text/]

КОМАНДЫ

alias [--edit] [alias|alias=command]

as-console-user command [args …]

autoremove [--dry-run]

bundle [subcommand]

casks

cleanup [options] [formula|cask …]

command command […]

command-not-found-init

commands [--quiet] [--include-aliases]

completions [subcommand]

config, --config

deps [options] [formula|cask …]

desc [options] formula|cask|text|/regex/ […]

developer [subcommand]

docs

doctor, dr [--list-checks] [--audit-debug] [diagnostic_check …]

exec, x [--formulae=formulae] [--sandbox=path] [--deny-network] [--] command [args …]

fetch [options] formula|cask […]

formulae

gist-logs [--new-issue] [--private] formula

help [command …]

home, homepage [--formula] [--cask] [formula|cask …]

info, abv [options] [formula|cask …]

install [options] formula|cask […]

leaves [--installed-on-request] [--installed-as-dependency]

link, ln [options] installed_formula […]

list, ls [options] [installed_formula|installed_cask …]

log [options] [formula|cask]

mcp-server [--debug]

migrate [options] installed_formula|installed_cask […]

missing [--hide=] [formula|cask …]

nodenv-sync

options [--compact] [--installed] [formula …]

outdated [options] [formula|cask …]

pin [--formula] [--cask] installed_formula|installed_cask […]

postinstall, post_install installed_formula […]

pyenv-sync

rbenv-sync

readall [options] [tap …]

reinstall [options] formula|cask […]

sandbox-exec [--deny-network] writable-path [--] command [args …]

search, -S [options] text|/regex/ […]

services [subcommand]

setup-ruby [command …]

setup-sandbox

shellenv [shell …]

source [formula …]

tab [options] installed_formula|installed_cask […]

tap [options] [user/repo] [URL]

tap-info [--installed] [--json] [tap …]

trust [options] [target …]

unalias alias […]

uninstall, remove, rm [options] installed_formula|installed_cask […]

unlink [--dry-run] installed_formula […]

unpin [--formula] [--cask] installed_formula|installed_cask […]

untap [--force] tap […]

untrust [options] [target …]

update, up [options]

update-if-needed

update-reset [repository …]

upgrade [options] [installed_formula|installed_cask …]

uses [options] formula […]

version-install formula[@version] [version]

which-formula [--explain] command […]

--cache [options] [formula|cask …]

--caskroom [cask …]

--cellar [formula …]

--env, environment [--shell=] [--plain] [formula …]

--prefix [--unbrewed] [--installed] [formula …]

--repository, --repo [tap …]