steve

Automate macOS UI tasks via the Accessibility API with JSON output.

168|6|Updated Jan 15, 2026

Search Tags:#testing #accessibility #cli #macos #json-output #uiautomation #steve

Ready to run

npx skills add https://github.com/mikker/steve --skill steve

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: steve
Source: https://github.com/mikker/steve/tree/main/skills/steve
Command: npx skills add https://github.com/mikker/steve --skill steve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate macOS applications through the Accessibility API to drive reliable UI interactions, enabling deterministic testing and scripting workflows.

Core Features & Use Cases

Target apps and windows using --app, --bundle, or --pid, then scope actions to a specific window for precise automation.
Find and interact with UI elements by text, title, or role, performing clicks, typing, and navigation, with JSON-formatted output for integration.
Use in UI smoke tests, automated demonstrations, and scripted UI experiments across macOS applications.

Quick Start

Install steve and grant Accessibility permissions to the terminal, then run a simple workflow to automate a macOS app.

Frequently Asked Questions about steve

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

FAQPage Schema

How do I automate macOS UI interactions for testing?▼

Automate macOS UI interactions by controlling applications and windows via the Accessibility API. You can find and interact with UI elements by text, title, or role to perform clicks, typing, and navigation for deterministic testing workflows.

Can I target a specific macOS application window for UI automation?▼

Yes, you can target specific macOS applications using --app, --bundle, or --pid arguments. This allows you to scope actions to a specific window for precise automation and scriptable control across apps like System Settings or Safari.

What is the best way to integrate macOS UI automation scripts into a pipeline?▼

Integrate macOS UI automation scripts by leveraging JSON-formatted output. The automation tool returns structured JSON output after controlling applications, making it easy to capture UI smoke testing results and integrate them into existing pipelines.

Does macOS Accessibility API automation require special permissions?▼

Yes, macOS Accessibility API automation requires granting Accessibility permissions to your terminal. You must install the steve CLI and provide terminal access so it can control applications and windows to drive reliable UI interactions.

How do I perform clicks and typing in macOS UI smoke tests?▼

Perform clicks and typing in macOS UI smoke tests by finding and interacting with UI elements through the Accessibility API. You can locate elements by text, title, or role, then execute automated interactions and scripted UI experiments across applications.