openclaw/AXorcist

Registry

Summary

AXorcist is a Swift wrapper for macOS Accessibility that enables chainable, fuzzy-matched queries to read, click, and inspect any UI element. It simplifies automation and testing by providing a powerful, expressive API for interacting with the accessibility layer.

Key features

• Chainable query API for intuitive UI element selection
• Fuzzy matching to locate elements with partial or approximate attributes
• Read, click, and inspect any macOS UI element via Accessibility
• Built on Swift for type safety and modern language features
• Lightweight library with no external dependencies

Use cases

• Automating repetitive UI tasks in macOS applications
• Writing integration tests for macOS desktop apps
• Building accessibility-aware tools and utilities
• Inspecting and debugging UI element hierarchies

README excerpt

# AXorcist 🧙‍♂️ - The power of Swift compels your UI to obey!  <p align="center"> <img src="assets/logo.png" alt="AXorcist Logo"> </p> <p align="center"> <strong>Swift wrapper for macOS Accessibility—chainable, fuzzy-matched queries<br>that read, click, and inspect any UI. The dark arts meet modern Swift!</strong> </p> --- > **Platform target:** macOS 14.0 and later. AXorcist sits on top of the Accessibility APIs that only ship on macOS, so CI and releases intentionally stay macOS-only. **AXorcist** harnesses the supernatural powers of macOS Accessibility APIs to give you mystical control over any application's interface. Whether you're automating workflows, testing applications, or building assistive technologies, AXorcist provides the incantations you need to make UI elements bend to your will. ## Overview AXorcist enables developers to create sophisticated automation tools, testing frameworks, and accessibility utilities by providing: - **Type-safe API**: Compile-time safety for accessibility attributes and operations - **Modern Swift Patterns**: Async/await, structured concurrency, and error handling - **Comprehensive Command System**: Query, action, observation, and batch operations - **Element Management**: Efficient UI element discovery and interaction - **Permission Handling**: Streamlined accessibility permission workflows --- *This document provides a comprehensive overview of all AXorcist classes and their usage patterns. For interactive API documentation, run `../view-docs.sh` to open the DocC archives.* ## Core Classes Reference ### AXorcist (Main Class) The central orchestrator for all accessibility operations. ```swift @MainActor public class AXorcist { static let shared = AXorcist()

Topics