BigArrow дозволяє ШІ-агентам виділяти елементи інтерфейсу macOS для підтвердження людиною

Усунення блокувань під час взаємодії з людиною

Автономні агенти розробки регулярно стикаються з межами, які не можуть подолати самостійно: запитами OAuth, підтвердженнями ключів доступу та діалогами дозволів macOS. У таких випадках моделі зазвичай виводять текстові повідомлення в термінал, за яким розробник не стежить. Утиліта bigarrow реалізує візуальний механізм сповіщень, написаний на Swift, без сторонніх залежностей та під ліцензією MIT.

Нативна інтеграція з macOS без перехоплення фокусу

Інструмент малює наскрізні графічні елементи поверх віконного менеджера macOS, підтримуючи роботу з кількома моніторами, Spaces та Stage Manager. Рендеринг виконується через Core Animation на рівні системного сервера, споживаючи близько 1.4% процесора на тестових стендах. Процес використовує явну обробку подій замість виклику NSApplication.run(), що гарантує збереження фокусу у вашому редакторі коду.

# Вказівка на елемент за назвою у конкретному застосунку
bigarrow point --element "Allow" --app "System Settings" --text "Підтвердіть дію"

# Вказівка за точними екранними координатами
bigarrow point --at 760,500 --text "Введіть код 2FA"

Протокол взаємодії з агентами та життєвий цикл

Стрілки зникають автоматично через 8 секунд за замовчуванням, за допомогою прапорця --until-click або коли батьківський процес агента завершує роботу через відстеження CLAUDE_PID чи BIGARROW_OWNER_PID. Інструмент повертає передбачувані коди помилок:

• 0: Успішне виконання
• 2: Некоректні вхідні аргументи
• 3: Цільове вікно чи елемент не знайдено
• 4: Відсутні дозволи Accessibility в macOS

Для Claude Code команду bigarrow stop --hook можна підключити до хука UserPromptSubmit, щоб автоматично очищати старі вказівники між запитами.