axbridge

Inspect and interact with macOS Accessibility UI elements using JXA.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/igot-ai/os-twin --skill axbridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axbridge
Source: https://github.com/igot-ai/os-twin/tree/main/.agents/skills/roles/macos-automation-engineer/axbridge
Command: npx skills add https://github.com/igot-ai/os-twin --skill axbridge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables automated inspection and interaction with macOS Accessibility UI elements, replacing manual UI exploration and control with scriptable actions.

Core Features & Use Cases

  • Dump UI trees and read text from arbitrary elements using JXA.
  • Click buttons, read attributes, and navigate menus across macOS apps to automate repetitive UI tasks.
  • Use cases include automated UI testing, accessibility-assisted automation, and workflow scripting for macOS apps.

Quick Start

Use axbridge to inspect and interact with macOS UI elements via JXA.

Frequently Asked Questions about axbridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS UI interactions using JXA?

You can automate macOS UI interactions using JXA by querying the Accessibility API to inspect UI trees, read text, and perform clicks across applications. This bridges scriptable actions to standard macOS UI elements.

What is the best way to script macOS accessibility elements for automated testing?

Scripting macOS accessibility elements for automated testing is best handled by dumping UI trees and reading attributes via JXA. This allows scripts to navigate menus and click buttons programmatically across macOS apps.

Do I need accessibility permissions to run JXA UI automation scripts on macOS?

Yes, you need accessibility permissions to run JXA UI automation scripts on macOS. The automation requires explicit accessibility access to query and interact with UI elements exposed through the AX API.

Can I read text and click buttons in macOS apps without a GUI using Bash?

Yes, you can read text and click buttons in macOS apps without a GUI by executing JXA commands through a Bash execution path. This scriptable approach uses the axbridge.sh script to interact with the AX API directly.

What are the limitations of using the macOS Accessibility API for workflow automation?

Limitations of using the macOS Accessibility API for workflow automation include reliance on applications properly exposing their UI elements to the AX API. If an app lacks accessibility support, JXA scripts cannot query or interact with its interface.