Repolode
franzenzenhofer

franzenzenhofer/big-arrow-on-the-screen

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

Звёзды
784
Форки
24
Открытые issues
4
Последний коммит
позавчера

Что это?

bigarrow — инструмент командной строки на Swift для macOS. Он рисует стрелку с табличкой поверх всех окон, на всех дисплеях и во всех Space. Щелчки проходят сквозь оверлей, фокус клавиатуры остаётся на прежнем месте, а стрелка исчезает по истечении заданного времени, при завершении процесса агента-владельца или по команде пользователя.

Главная задача инструмента — помогать AI-агентам указывать человеку на элементы экрана: например, запрос разрешения, кнопку, которую нужно нажать, или этап с 2FA, который агент не может выполнить сам. Цель можно задать координатами, именем окна или приложения либо меткой элемента интерфейса, найденного через Accessibility API. Сам инструмент не нажимает кнопки, не вводит текст и не захватывает экран.

Инструмент поставляется одним бинарным файлом: без демона, значка в строке меню и учётной записи. Установить его можно через Homebrew. Установщик навыка добавляет инструкции для Claude Code и Codex. Для стрелок доступны разные формы, стили и цвета, а на табличку можно добавить кнопку копирования значения в буфер обмена.

Ключевые возможности

  • 01Рисует стрелки, кольца и рамки с табличками поверх всех окон и во всех Space.
  • 02Щелчки проходят сквозь оверлей, а фокус клавиатуры не перехватывается.
  • 03Позволяет задать цель координатами, именем окна или приложения либо меткой элемента Accessibility.
  • 04Стрелки автоматически исчезают по истечении заданного времени, при завершении процесса-владельца или по команде остановки.
  • 05Предусмотрены кнопка копирования значения с таблички и синтез речи через --say.
  • 06Поддерживает вывод в JSON и заданные коды завершения для скриптов.

Сценарии использования

  • Подсказать пользователю, какую кнопку нажать, когда агенту нужно получить разрешение.
  • Указать человеку на этап с 2FA, CAPTCHA или оплатой, который агенту не следует выполнять.
  • Пошагово провести человека по интерфейсу приложения или помочь родственнику во время демонстрации экрана.
  • Подсветить элементы интерфейса при записи демонстраций или создании скриншотов с аннотациями.

Быстрый старт

  1. 1

    Установить через Homebrew

    brew install franzenzenhofer/tap/bigarrow
  2. 2

    Обучить Claude Code и Codex навыку

    bigarrow install-skill
  3. 3

    Указать стрелкой на элемент интерфейса

    bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"

Что важно знать

  • Только для macOS; для сборки из исходного кода требуется macOS 14 или новее.
  • Для сборки из исходного кода требуется Xcode 16 или новее.
  • Только указывает на объекты — не нажимает, не вводит текст и не захватывает экран.

Темы

Частые вопросы

Что такое big-arrow-on-the-screen?
CLI для macOS и навык AI-агента: выводит на экран крупные стрелки, рамки и таблички, чтобы указать на элементы интерфейса, не нажимая и не захватывая экран. bigarrow — инструмент командной строки на Swift для macOS. Он рисует стрелку с табличкой поверх всех окон, на всех дисплеях и во всех Space. Щелчки проходят сквозь оверлей, фокус клавиатуры остаётся на прежнем месте, а стрелка исчезает по истечении заданного времени, при завершении процесса агента-владельца или по команде пользователя.
big-arrow-on-the-screen можно использовать бесплатно? Какая у него лицензия?
big-arrow-on-the-screen распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
big-arrow-on-the-screen всё ещё поддерживается?
Активно поддерживается. Последний коммит в big-arrow-on-the-screen — 18 окт. 2026 г..
Для чего можно использовать big-arrow-on-the-screen?
Подсказать пользователю, какую кнопку нажать, когда агенту нужно получить разрешение. Указать человеку на этап с 2FA, CAPTCHA или оплатой, который агенту не следует выполнять. Пошагово провести человека по интерфейсу приложения или помочь родственнику во время демонстрации экрана. Подсветить элементы интерфейса при записи демонстраций или создании скриншотов с аннотациями.
Как установить big-arrow-on-the-screen?
Установить через Homebrew: brew install franzenzenhofer/tap/bigarrow Обучить Claude Code и Codex навыку: bigarrow install-skill Указать стрелкой на элемент интерфейса: bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"
Где скачать big-arrow-on-the-screen?
Исходный код и инструкции по установке — на GitHub: https://github.com/franzenzenhofer/big-arrow-on-the-screen

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты