Утилита bigarrow для macOS даёт ИИ-агентам рисовать стрелки на экране

Утилита bigarrow для macOS даёт ИИ-агентам рисовать стрелки на экране

На GitHub опубликован проект big-arrow-on-the-screen (команда bigarrow) под лицензией MIT. Это консольная утилита для macOS плюс навык (skill) для Claude Code и Codex, которая рисует поверх всех окон стрелку и табличку с текстом. Клики проходят сквозь неё, фокус клавиатуры не сдвигается, а стрелка исчезает сама.

Идея из README: ИИ-агент умеет рефакторить монорепозиторий и писать миграции, но когда ему нужно, чтобы человек нажал одну кнопку, он печатает «пожалуйста, нажмите Allow в диалоговом окне» в терминал, на который вы не смотрите. bigarrow даёт агенту «палец»: команда вроде bigarrow point --element "Allow" --app "System Settings" --text "..." находит элемент по подписи и показывает на него стрелкой.

Что это за инструмент. Один прозрачный слой над всем на каждом дисплее и в каждом Space. Для рисования не нужны разрешения macOS. Это один бинарник на Swift: без демона, значка в строке меню, аккаунта и телеметрии, и, как подчёркивают авторы, без ИИ внутри. Инструмент только показывает: он ничего не нажимает, не вводит и не снимает экран.

Когда это нужно. Авторы называют сценарии: окна с запросом разрешений, согласие OAuth, двухфакторная аутентификация, CAPTCHA, ключи доступа (passkeys), платежи и подписи (агент показывает, человек решает, агент продолжает); код или команда на табличке с кнопкой копирования (значение в {{...}} превращается в кнопку); голосовое озвучивание таблички через --say, если вы отошли от компьютера; пошаговая подсказка «покажи, как» в Blender; помощь родственнику на чужом Mac; демо и документация (отрисовка в PNG через --png); отладка координат Accessibility и Peekaboo (--dry-run --json).

Как задать цель. Координаты (--at X,Y), прямоугольник (--rect), положение мыши (--mouse), окно (--window Приложение[:заголовок]), элемент по подписи (--element Подпись --app Приложение) или идентификатор Peekaboo (--peekaboo ID --snapshot see.json). Опция --app сначала выводит нужное приложение, окно или вкладку Chrome/Safari на передний план (отключается через --no-raise). Каждая команда принимает --json, коды выхода: 0, успех, 2, неверный ввод, 3, цель не найдена, 4, не хватает разрешения.

Внешний вид. Формы: bend, straight, zigzag, spiral; стили arrow, ring, box (кольца и рамки, контуры, цель остаётся видна); размеры S, M, L; углы round или sharp; цвета из набора или #RRGGBB; несколько стрелок одновременно не мешают табличкам друг друга. Есть --close-button (крестик на табличке), --follow (стрелка движется за окном или элементом), --until-click (завершение по клику на цели).

Установка: brew install franzenzenhofer/tap/bigarrow, затем bigarrow install-skill, который обучает Claude Code (/.claude/skills) и Codex (/.agents/skills). Из исходников: swift build -c release (Xcode 16+, macOS 14+).

Авторы заявляют, что проверили двадцать шесть существующих инструментов и ни один не делал этого. Заявляют также, что проект набрал почти 400 звёзд за первые два дня, причём от людей, в профилях которых указаны Apple, NVIDIA, AMD, SAP, Salesforce и ряд других компаний и университетов.

Ключевые факты

  • bigarrow, консольная утилита для macOS (MIT) плюс навык для Claude Code и Codex: рисует поверх окон стрелку с табличкой и показывает человеку, что нажать; сама она только указывает и никогда не кликает, не вводит текст и не снимает экран.
  • Установка через Homebrew (brew install franzenzenhofer/tap/bigarrow) и команда bigarrow install-skill; сборка из исходников требует Xcode 16+ и macOS 14+.
  • Цель можно задать координатами, окном, подписью элемента или идентификатором Peekaboo; у команд есть вывод --json и коды выхода 0, 2, 3, 4.
  • Описание навыка занимает 182 токена, инструкции 1 398 токенов (загружаются, только когда агент решает показать), ещё 1 008 токенов, по необходимости.
  • Авторы приводят 104 автоматических теста и 18 проверок поведения на чистом раннере; CI работает на macOS 15, прохождение на macOS 26 и 27 также заявлено.

Почему это важно

Агенты всё чаще работают прямо на компьютере человека и упираются в шаги, которые должен выполнить только человек: подтвердить разрешение, ввести PIN, пройти CAPTCHA, подписать. Обычно агент просто пишет об этом в терминал, который пользователь может не видеть. bigarrow предлагает узкий и намеренно ограниченный ответ: не давать агенту больше власти, а позволить ему показать пальцем на нужный элемент. Это небольшой инструмент независимого проекта, но он показывает, как можно закрыть разрыв между агентом и человеком без расширения прав агента.

Кому это важно

Прежде всего пользователям Claude Code и Codex на macOS, чьи агенты регулярно упираются в окна разрешений и подтверждений. Также тем, кто записывает демо и документацию (стрелку можно отрисовать в PNG), тем, кто помогает другим людям на их Mac или через демонстрацию экрана, и разработчикам, которые отлаживают координаты Accessibility или Peekaboo.

Как это применить

Установите утилиту через Homebrew командой brew install franzenzenhofer/tap/bigarrow, затем выполните bigarrow install-skill: он добавит навык в ~/.claude/skills для Claude Code и в ~/.agents/skills для Codex. Для проверки можно запустить, например, bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow" (поиск по подписи) или bigarrow point --at 760,500 --text "Franz, click HERE" (по координатам). Команда bigarrow elements --app X показывает, какие элементы можно указать в --element, а bigarrow doctor, разрешения и дисплеи. Сборка из исходников: swift build -c release, нужны Xcode 16+ и macOS 14+. Лицензия MIT; цен в README нет.

Можно ли доверять

Все сведения взяты из README самого проекта, то есть это описание от его авторов, а не независимая проверка. Число звёзд («почти 400 за два дня»), перечень компаний и университетов в профилях звёзд и утверждение, что из двадцати шести проверенных инструментов ни один не делал этого, собственные заявления авторов. Тесты, измерение нагрузки на процессор (1,4 % на раннере CI) и подсчёт токенов также приведены самими авторами. Плюс: показаны конкретные команды, скриншоты, видео и список тестов, которые можно воспроизвести.

Риски и подводные камни

Рисование не требует разрешений macOS, но некоторые способы найти цель требуют: их выдают приложению, которое запустило bigarrow (Terminal, iTerm2, Ghostty, VS Code, Claude), а не самой утилите; при нехватке разрешения команда завершается кодом 4. В Chrome поиск элементов страницы работает только с флагом --force-renderer-accessibility или при включённом VoiceOver (авторы проверяли в октябре 2026 года); панель инструментов Chrome работает всегда, а для страницы остаются координаты. Возможен вопрос, не может ли агент обмануть человека, закрыв стрелкой кнопку Decline: авторы отвечают, что утилита не даёт агенту ничего нового, ведь агент с доступом к оболочке и так может сделать гораздо больше, и перечисляют защиты (контурные рамки, табличка не перекрывает цель, клик по табличке или стержню убирает стрелку, каждая стрелка исчезает сама). Это заявление авторов, а не независимый аудит.

«пожалуйста, нажмите Allow в диалоговом окне»

— README проекта bigarrow, о том, что ИИ-агент печатает в терминал