Документация

Обзор

Burrow — нативное приложение для macOS; для Windows есть сборка на WinUI 3 в бета-версии. Оно закрывает задачи, которые обычно распределяют между чистильщиком, деинсталлятором, поиском дубликатов, картой диска и монитором в строке меню, и открывает всё это агентам-программистам через MCP.

Четырнадцать инструментов делят одно окно. Каждый перекрашивает интерфейс в свой цвет, потому что цвет — это способ сказать, к чему инструмент сейчас прикоснётся. У двух из них вообще нет аналога в командной строке: у истории за долгий срок и у MCP-сервера.

Всё работает локально. Результаты сканирования, метрики и история остаются на компьютере, а MCP-сервер слушает только локальную петлю.

Установка

На macOS Homebrew — самый короткий путь. Он ставит сборку, подписанную Developer ID и заверенную Apple, вместе со встроенным движком, и сохраняет карантин, чтобы Gatekeeper мог проверить квитанцию.

brew install --cask caezium/tap/burrow

Прямые загрузки и предварительная версия для Windows — на странице установки. Обновления приходят в само приложение по подписанному каналу Sparkle; установленное через Homebrew обновляется командой brew upgrade.

Полный доступ к диску

Без него Burrow выполняет безопасное сканирование. Полный доступ к диску позволяет ему добраться до более глубоких кэшей в Application Support и контейнерах, которые macOS иначе скрывает. Выдать или отозвать его можно в любой момент в Системных настройках, в разделе «Конфиденциальность & безопасность».

Возвращаем место

Очистка

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

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

Глубокая очистка

Порода, которую оставляет разработка; она отделена от обычных кэшей, потому что соображения тут другие. Результаты сборки вроде dist, build, target, .next, .build, DerivedData, __pycache__ и coverage пересобираются локально и без сети. А каталоги зависимостей вроде node_modules, Pods и venv нужно загружать заново, поэтому они показаны с этой ценой и остаются без отметки, пока вы их не подтвердите.

Установщики

Находит файлы .dmg и .pkg , всё ещё лежащие в «Загрузках» спустя долгое время после установки программы. По отдельности небольшие, но на компьютере, работающем несколько лет, часто складываются в десятки гигабайт.

Дубликаты

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

Похожие фото

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

Программы

Программы

Все установленные программы с сортировкой по размеру, имени, недавнему использованию или источнику. При удалении нескольких сразу вместе с самой программой уходят её настройки, данные в Application Support, контейнеры, сохранённое состояние и агенты запуска.

Вкладка Homebrew проверяет, какие cask и formula устарели, и обновляет их на месте. Burrow опирается на токен cask, а не на отображаемое имя, потому что у десятка популярных программ токен отличается от того, как программа себя называет.

Остатки

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

Агенты запуска от удалённых программ стоит убирать в первую очередь. launchd продолжает пытаться запустить исполняемый файл, которого больше нет, и засоряет журнал при каждой загрузке.

Обслуживание

Оптимизация

Рутинные дела, собранные за одним запросом: пересобрать Quick Look, починить кэши и метаданные, сбросить DNS и проверить объекты входа.

Настройка

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

Разбираемся с диском

Анализ

Древовидная карта всего тома, где размер — это реально занятые байты. Спуститесь в любую ветку, чтобы увидеть ту же разбивку уровнем ниже, а затем покажите её в Finder или отправьте в Корзину из контекстного меню.

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

Наблюдаем за компьютером

Состояние

CPU, память, GPU, диск, сеть и батарея на одной странице, у каждого свой мини-график. Таблицу процессов можно сортировать по любому столбцу и закреплять строки, которые нужно держать на виду. На Apple Silicon скорость вентиляторов и температуры кристалла читаются напрямую из SMC.

История

Каждый замер, который делает «Состояние», попадает в локальный файл SQLite. Отматывайте от пяти минут до девяноста дней, с таблицами пиков по процессам для тех моментов, когда вентиляторы действительно раскручивались. Ничего никуда не отправляется.

Порты

Все прослушиваемые порты с процессами, путями к исполняемым файлам и владельцами, с обновлением в реальном времени. Узнайте, кто занял порт 3000, без запуска lsof.

Сеть

Скорость в реальном времени по интерфейсам и по процессам. В отличие от накопленных итогов «Мониторинга системы», это именно скорость, поэтому процесс, который сейчас забивает канал, окажется наверху.

Вернуть сеть

Пошаговый путь наверх, когда связь пропала: состояние интерфейса, разрешение DNS, доступность шлюза и определение страницы авторизации — проверяются по порядку.

Панель в строке меню

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

Агенты и MCP

Burrow заодно работает как MCP-сервер, поэтому агент-программист может спрашивать сам компьютер, а не догадываться по вашему коду. Открыто двадцать шесть инструментов. Четырнадцать только читают и доступны сразу; те, что меняют компьютер, требуют собственного явного разрешения в настройках, прежде чем агент вообще сможет их вызвать.

Направьте Claude Code на приложение:

{
  "mcpServers": {
    "burrow": {
      "command": "/Applications/Burrow.app/Contents/MacOS/Burrow",
      "args": ["--mcp"]
    }
  }
}

Инструменты только для чтения

burrow_snapshot, burrow_history, burrow_top_processes, burrow_process_usage, burrow_info, burrow_analyze, burrow_dupes, burrow_orphans, burrow_photos, burrow_ports, burrow_net, burrow_doctor, burrow_disk_forecast и burrow_list_apps.

Инструменты с разрешением

burrow_clean, burrow_purge, burrow_uninstall, burrow_optimize и burrow_installer меняют компьютер и остаются недоступными, пока вы их не включите.

HTTP API

HTTP-интерфейс на локальной петле по адресу 127.0.0.1:9277 отдаёт те же данные только для чтения инструментам, которые говорят по HTTP, а не по MCP. По умолчанию он включён и отключается в настройках. Он слушает только локальную петлю и никогда не доступен с другого компьютера.

Модель безопасности

Burrow построен так, чтобы ошибка стоила вам пересборки, а не данных. Четыре правила действуют во всём приложении.

• Сначала показать, потом удалять. Любое действие сначала перечисляет файлы и объём. Вы подтверждаете — Burrow действует.
• Отсортировано по последствиям. Категории упорядочены по тому, насколько безопасно их удалять, а всё, что придётся заново долго собирать, остаётся без отметки, пока вы не поставите её сами.
• Никакого фонового помощника с правами root. Когда задаче нужны права администратора, спрашивает собственное окно macOS, Burrow выполняет ровно одну команду, и процесс завершается. Никакой привилегированной службы после этого не остаётся.
• Список защиты, который можно прочитать. Пути, которые никогда не подлежат удалению, закреплены в коде, а не в договорённостях, и этот код открыт.

Подпись и заверение

Версия 0.11.0 и все последующие выпуски для macOS подписаны Developer ID и заверены Apple, и тег не может быть опубликован, пока не пройдут подпись, заверение, прикрепление квитанции и проверка Gatekeeper. Архивные сборки 0.10.5 и старше появились до этой гарантии: если Gatekeeper блокирует такую, нажмите правой кнопкой и выберите «Открыть».

Приватность и телеметрия

Ни файлы, ни пути, ни адреса, ни метрики не покидают компьютер. Сканирование, история и MCP-сервер полностью локальны.

Burrow всё же отправляет анонимные данные об использовании и диагностику, которые можно отключить: отчёты о сбоях и зависаниях, результаты запуска и обновления, а также выборочные замеры производительности с фиксированными именами. Он никогда не записывает экран и никогда не отправляет файлы пользователя или их содержимое. Один переключатель в настройках останавливает обе службы, а сборки из исходников поставляются с выключенной телеметрией.

Все поля перечислены в TELEMETRY.md. Кроме того, этот сайт использует аналитику без cookie: она не создаёт профиль человека, не хранит идентификатор браузера, убирает из адресов параметры и якоря и уважает Do Not Track.

Если что-то пошло не так

Gatekeeper блокирует приложение

Начиная с 0.11.0 такого быть не должно; если это всё же случилось, загрузку, скорее всего, изменили по дороге — скачайте её заново с GitHub. Для архивных сборок нажмите на приложение правой кнопкой и выберите «Открыть».

Полный доступ к диску выглядит выданным, но сканирование остаётся поверхностным

macOS привязывает разрешение к подписи кода приложения. Замена приложения на сборку с другой подписью делает разрешение недействительным. Удалите Burrow из списка полного доступа к диску и добавьте его заново.

Свободного места не прибавилось

Удаление файла не освобождает блоки, на которые всё ещё ссылается локальный снимок Time Machine. При нехватке места macOS прореживает снимки автоматически. tmutil listlocalsnapshots / показывает, что есть сейчас.

Агент не видит инструменты, требующие разрешения

Очистка, удаление и прочие инструменты, которые действительно что-то делают, остаются скрытыми, пока вы не включите действия агентов в настройках. Так задумано: агент не должен иметь возможности удалить то, что вы отдельно не разрешили.