AI 에이전트가 화면에 화살표와 텍스트를 그리게 해주는 macOS 도구

핵심 요약

• bigarrow는 macOS 명령줄 도구로, AI 에이전트가 화면 위에 투명한 화살표와 텍스트 레이블을 그려서 사용자를 특정 버튼이나 UI 요소로 안내한다.
• Swift 바이너리 하나로 구성되며 데몬, 메뉴바 아이콘, 텔레메트리가 없고, 그리기 자체는 macOS 권한을 필요로 하지 않는다.
• 화살표는 모든 윈도우, 디스플레이, Space 위에 떠있는 투명 윈도우에 렌더링되고, 클릭은 아래 앱으로 통과되며 키보드 포커스는 유지된다.
• 보안 권한 확인 대화상자, OAuth 화면, 2FA 코드 입력 등 AI가 대신 조작할 수 없는 작업에서 사용자의 개입을 요청할 때 유용하다.
• --element로 라벨로 찾기, --at 좌표로 찾기, --window 앱 또는 탭으로 찾기 등 여러 방식으로 타겟을 지정할 수 있다.
• --shape (straight/bend/zigzag/spiral), --style (arrow/ring/box), --color, --size 등으로 화살표의 모양을 커스터마이징할 수 있다.
• 화살표는 지정된 시간(기본 8초, 최대 300초)이 지나거나 에이전트 프로세스가 끝나거나 사용자가 --hook으로 제거하면 자동으로 사라진다.
• Claude Code와 Codex를 위한 스킬로 제공되며, 스킬의 토큰 사용량은 항상 약 190개, 실제 명령 때만 2,200개가 로드된다.
• 91개의 자동화된 테스트(기하학, 배치, 이미지 검증, 접근성)와 17개의 동작 검증(실제 클릭, 포커스 변경 없음, 여러 디스플레이)을 통해 검증되었다.
• CPU 사용량은 맥북에서 1.4%이며, 윈도우 서버 레벨에 있어서 일반 윈도우나 풀스크린 앱 위에 나타난다.
• 화살표는 접근성 API로 찾은 요소는 노출시킨 상태로 유지하고, 클릭은 화살표 자체 또는 배경 영역에서만 제거된다.
• 다중 디스플레이, 풀스크린 앱, Stage Manager, Space 전환을 모두 지원하며 MIT 라이선스로 제공된다.