Homebrew

Какую задачу решает

Ставит консольные программы одной командой: brew install ffmpeg, и программа готова к работе вместе со всем, что ей нужно. На Mac почти все программы этого раздела ставятся через Homebrew, поэтому без него агент застревает на первом шаге; работает и на Linux. Рецепт установки программы Homebrew называет формулой, в основном каталоге их больше 8 тысяч.

• Ставит программу одной командой brew install вместе со всем, что ей нужно: FFmpeg, Pandoc, yt-dlp, uv, Git, Node.js, GitHub CLI, ImageMagick.
• До установки показывает, что поставится и что обновится вместе с программой: brew install --dry-run.
• Показывает, что стоит и что устарело (brew list, brew outdated), обновляет и удаляет по одной программе: brew upgrade <имя>, brew uninstall <имя>.
• На Mac ставит и обычные приложения с окнами, например браузер: brew install --cask firefox.
• Подключается к агенту как MCP-сервер: команда brew mcp-server встроена в Homebrew, её подключают к Claude Desktop, Cursor и VS Code.

Пример результата

Установить агентом

Установи программу «Homebrew». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 28.09.2026):
- официальный сайт: https://brew.sh/
- исходный код: https://github.com/Homebrew/brew
- инструкция по установке: https://docs.brew.sh/Installation
- актуальная версия на 28.09.2026: 7.0.7
- лицензия: BSD-2-Clause
- для работы нужно (обязательно): Git - без него установщик с brew.sh останавливается. На Mac Git приходит с инструментами командной строки Xcode, и установщик ставит их сам, если есть права администратора; установщику .pkg Git не нужен
- для работы нужно (обязательно): build-essential, procps, curl и file (Linux) - компилятор и стандартные инструменты, которых Homebrew ждёт на Linux; на Debian и Ubuntu ставятся одной командой: sudo apt-get install build-essential procps curl file git
- для работы нужно (в отдельных случаях): Инструменты командной строки Xcode (Command Line Tools) - на Mac нужны, чтобы собирать программы из исходников; готовые сборки и приложения на Apple Silicon ставятся без них
- для работы нужно (в отдельных случаях): WSL 2 (Windows) - только на Windows: Homebrew работает внутри WSL 2, а WSL ставится командой wsl --install в PowerShell от администратора, потом перезагрузка

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.
6. Homebrew ставь только официальными способами: командой с brew.sh или файлом Homebrew.pkg со страницы выпусков github.com/Homebrew/brew. Команды установки Homebrew из других мест не бери.
7. Для Homebrew это две разные просьбы, спрашивай про каждую отдельно: первая установка с sudo (если она спросит пароль администратора, дай команду мне, я запущу её в своём терминале) и строка eval "$(<папка Homebrew>/bin/brew shellenv)" в ~/.zprofile или ~/.bashrc.
8. Не запускай brew upgrade без имени программы: он обновит разом всё, в том числе Python и Node.js, на которых работают мои проекты. Обновляй только программу, которую я назову, и после моего «да».
9. brew install - только для программ, которые я назвал. Перед установкой покажи вывод brew install --dry-run <имя>: что поставится и что обновится вместе с ней.
10. Сторонние tap (репозитории формул не от Homebrew) не подключай и не отмечай доверенными (brew tap, brew trust) без моего «да»: их код запускается с моими правами.
11. Не запускай brew через sudo: Homebrew работает от пользователя, которому принадлежит.
12. Удаление Homebrew запускай только после моего «да» и сначала с флагом -- --dry-run: вместе с Homebrew удалятся все программы, поставленные через него.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: основной вариант для Mac. Первая установка просит пароль администратора, дальше консольные программы ставятся без sudo.
   - на сервере: пригодится на Linux-сервере, когда нужной программы нет в пакетах дистрибутива или там старая версия. Homebrew рассчитан на одного пользователя-владельца, sudo нужен один раз: создать папку /home/linuxbrew/.linuxbrew.
   - в контейнере: есть официальный образ ghcr.io/homebrew/brew. В свой образ на Ubuntu ставится той же командой от обычного пользователя: в контейнере Ubuntu 24.04 установка заняла 37 секунд.
1. Проверь, не стоит ли программа уже: brew --version ; ls /opt/homebrew/bin/brew /usr/local/bin/brew /home/linuxbrew/.linuxbrew/bin/brew. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Проверь, что есть всё нужное для работы: Git, build-essential, procps, curl и file (Linux). Чего нет, внеси в план отдельным пунктом. Проверь свободное место на диске: нужно около 260 МБ (замер в контейнере Ubuntu 24.04: сама установка 213 МБ, из них история репозитория Homebrew 140 МБ и встроенный Ruby 46 МБ, плюс кэш загрузок 44 МБ); установщик .pkg для Mac весит около 150 МБ; каждая программа добавляет своё, jq с зависимостью - 3,5 МБ.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS и Linux, установщик с brew.sh: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" (покажет, что сделает, и спросит подтверждение и пароль администратора; профиль оболочки не правит, строку для него печатает в конце)
   - macOS, установщик .pkg: sudo installer -pkg Homebrew.pkg -target / (файл Homebrew.pkg, около 150 МБ, со страницы https://github.com/Homebrew/brew/releases/latest; только Apple Silicon и macOS 15 и новее; Git и инструменты Xcode не нужны; файл можно открыть и двойным щелчком)
   - Windows, установщик с brew.sh внутри WSL 2: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" (только если агент сам работает внутри WSL 2: агенту в самой Windows программы из WSL напрямую не видны, там ставь программы через winget)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - brew --version: программа запускается без ошибки;
   - Предложи для проверки поставить маленькую программу jq для работы с JSON, около 3,5 МБ вместе с зависимостью. После моего «да» поставь её, прогони на своём тестовом файле и спроси, оставить её или удалить. Удаление: brew uninstall jq, потом brew autoremove --dry-run, и убирай только то, что пришло вместе с jq, после моего «да». Делай это во временной папке и не трогай мои файлы.
     brew install --dry-run jq
     brew install jq
     printf '{"items":[{"name":"ffmpeg","mb":150},{"name":"pandoc","mb":45}]}' > check.json
     jq -r '.items[] | select(.mb > 100) | .name' check.json
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS и Linux, установщик с brew.sh: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"; macOS, установщик .pkg: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"; Windows, установщик с brew.sh внутри WSL 2: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)").

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/homebrew#problemy

Промпт собран из официальных инструкций, сверенных 28.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

• macOS и Linux · установщик с brew.sh · источник

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

  покажет, что сделает, и спросит подтверждение и пароль администратора; профиль оболочки не правит, строку для него печатает в конце

• macOS · установщик .pkg · источник

  sudo installer -pkg Homebrew.pkg -target /

  файл Homebrew.pkg, около 150 МБ, со страницы https://github.com/Homebrew/brew/releases/latest; только Apple Silicon и macOS 15 и новее; Git и инструменты Xcode не нужны; файл можно открыть и двойным щелчком

• Windows · установщик с brew.sh внутри WSL 2 · источник

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

  только если агент сам работает внутри WSL 2: агенту в самой Windows программы из WSL напрямую не видны, там ставь программы через winget

Как удалить

• macOS и Linux, установщик с brew.sh: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
• macOS, установщик .pkg: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
• Windows, установщик с brew.sh внутри WSL 2: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

Что нужно для работы

• Git (обязательно) - без него установщик с brew.sh останавливается. На Mac Git приходит с инструментами командной строки Xcode, и установщик ставит их сам, если есть права администратора; установщику .pkg Git не нужен
• build-essential, procps, curl и file (Linux) (обязательно) - компилятор и стандартные инструменты, которых Homebrew ждёт на Linux; на Debian и Ubuntu ставятся одной командой: sudo apt-get install build-essential procps curl file git
• Инструменты командной строки Xcode (Command Line Tools) (в отдельных случаях) - на Mac нужны, чтобы собирать программы из исходников; готовые сборки и приложения на Apple Silicon ставятся без них
• WSL 2 (Windows) (в отдельных случаях) - только на Windows: Homebrew работает внутри WSL 2, а WSL ставится командой wsl --install в PowerShell от администратора, потом перезагрузка

Системы

• macOS - на Apple Silicon полная поддержка macOS 15 Sequoia, 26 Tahoe и 27 Golden Gate, на macOS 11-14 работает без гарантий. На Mac с Intel официальный установщик больше не ставит Homebrew. Уже поставленный работает там без поддержки как минимум до сентября 2027. macOS 10.15 и старше не поддерживается.
• Windows - только если агент сам работает внутри WSL 2: агенту в самой Windows программы из WSL напрямую не видны, там ставь программы через winget
• Linux - процессоры x86_64 и ARM64. Полная поддержка - Ubuntu с glibc 2.39 и новее (Ubuntu 24.04); на системах с glibc от 2.13 до 2.38, например Ubuntu 22.04, Homebrew сам ставит свою glibc и работает без гарантий.

Где запускать

Ставить нужно туда, где работает агент: на твой компьютер, сервер или в контейнер.

• На компьютере - основной вариант для Mac. Первая установка просит пароль администратора, дальше консольные программы ставятся без sudo.
• На сервере - пригодится на Linux-сервере, когда нужной программы нет в пакетах дистрибутива или там старая версия. Homebrew рассчитан на одного пользователя-владельца, sudo нужен один раз: создать папку /home/linuxbrew/.linuxbrew.
• В контейнере - есть официальный образ ghcr.io/homebrew/brew. В свой образ на Ubuntu ставится той же командой от обычного пользователя: в контейнере Ubuntu 24.04 установка заняла 37 секунд.

Сколько ресурсов нужно

Место на диске

Около 260 МБ (замер в контейнере Ubuntu 24.04: сама установка 213 МБ, из них история репозитория Homebrew 140 МБ и встроенный Ruby 46 МБ, плюс кэш загрузок 44 МБ); установщик .pkg для Mac весит около 150 МБ; каждая программа добавляет своё, jq с зависимостью - 3,5 МБ

Сеть

Установка скачала 145 МБ (замер в контейнере). Готовые сборки программ Homebrew качает с ghcr.io, а перед brew install раз в сутки сам обновляет список программ.

Кэш загрузок лежит в ~/Library/Caches/Homebrew на Mac и в ~/.cache/Homebrew на Linux. После установок и обновлений Homebrew сам чистит старое по этим программам, раз в 30 дней - по всем; вручную - brew cleanup.

Лицензия и платные замены

Лицензия BSD-2-Clause. Это условия самого Homebrew, они важны тем, кто распространяет его код. У программ, которые Homebrew ставит, свои лицензии: их показывает brew info <имя>. Текст лицензии

Цена: Бесплатно

Платные замены

Платной замены нет: менеджеры пакетов для Mac, Linux и Windows бесплатные. Homebrew делают добровольцы, проект живёт на пожертвованиях.

Бесплатные замены

• MacPorts - Менеджер пакетов для Mac с открытым кодом. Разработчики Homebrew сами советуют его владельцам Mac с Intel, есть установщики и для старых версий macOS.
• winget - Менеджер пакетов, встроенный в Windows 11 и современные Windows 10. Ставит программы в саму Windows, без WSL.

О чём помнить

• Команда с brew.sh скачивает установщик из интернета и сразу его запускает. Установщик сначала показывает, что сделает, и ждёт подтверждения. В режиме NONINTERACTIVE=1 и когда его запускает агент без терминала, он не ждёт: запускать его стоит только после твоего «да».
• На Mac первая установка просит пароль администратора: создать папку /opt/homebrew, добавить /opt/homebrew/bin в системный PATH (файл /etc/paths.d/homebrew) и, если нет Git, поставить инструменты командной строки Xcode. Дальше консольные программы ставятся без sudo, пароль спрашивают только некоторые приложения и службы.
• Профиль оболочки установщик сам не правит. В конце, в разделе «Next steps», он печатает строку eval "$(/opt/homebrew/bin/brew shellenv zsh)" для ~/.zprofile, на Linux - такую же с папкой /home/linuxbrew/.linuxbrew для ~/.bashrc. Документация Homebrew предупреждает: без неё Homebrew работать не будет.
• brew upgrade без имени обновляет разом все программы, а brew install может заодно обновить уже стоящие, если они нужны новой. Старые версии Homebrew удаляет сам, поэтому обновление Python или Node.js может сломать проекты, которые на них работают. Что изменится, заранее покажет brew install --dry-run.
• Tap - сторонний репозиторий с формулами, а формула - рецепт установки программы. Код из tap запускается с правами твоего пользователя, поэтому с версии 6.0 Homebrew требует явного доверия к tap не от Homebrew. Подключай их, только если знаешь автора.
• Удаление Homebrew стирает и все программы, поставленные через него, и кэш загрузок. Строку brew shellenv из профиля команда удаления не убирает: после удаления её нужно стереть, агент сделает это с твоего «да», иначе новый терминал будет писать ошибку. Что удалится, заранее покажет та же команда удаления с флагом: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" -- --dry-run
• Homebrew собирает анонимную статистику установок, без идентификатора пользователя и IP-адреса. Отключить: brew analytics off.

Частые проблемы

Проверка

✓ Проверено 28.09.2026: Docker-контейнер Ubuntu 24.04.5 LTS, ARM64 (linux/arm64), glibc 2.39, отдельный пользователь без root, sudo без пароля.

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.