io.github.oozoofrog/baepsae
NPM · MCP-BAEPSAE · SCANNED AUG 3
Local MCP server for iOS Simulator and macOS app automation with a native Swift bridge
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security80
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
- Runs a script at install time (postinstall) that we could not recognise. It may be perfectly ordinary, but we do not read the published tarball, so we cannot say what it does. View diagnostics → Partial
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to oozoofrog/mcp-baepsae). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 124 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability70
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 4194 tokens (~89/item across 47 items; 47 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage99
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 97% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · mcp-baepsae
claude mcp add oozoofrog-baepsae -- npx -y mcp-baepsae
codex mcp add oozoofrog-baepsae -- npx -y mcp-baepsae
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"oozoofrog-baepsae": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-baepsae"
],
"enabled": true
}
}
} openclaw mcp add oozoofrog-baepsae --command npx --arg -y --arg mcp-baepsae
mcp_servers:
oozoofrog-baepsae:
command: "npx"
args: ["-y", "mcp-baepsae"] {
"mcpServers": {
"oozoofrog-baepsae": {
"command": "npx",
"args": [
"-y",
"mcp-baepsae"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +4
- Stability: unverified → 0.23 ▲ functional
- 2 Aug 26 +67
- Install scripts: unverified → partial ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- The scripts that run when this package is installed changed: postinstall security
- The attested source repository moved: oozoofrog/mcp-baepsae security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: MIT functional
- 1 Aug 26 −23
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 30 Jul 26 +22
- Tool coverage: unverified → 100 ▲ functional
- 28 Jul 26 −22
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- 27 Jul 26 46
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- oozoofrog/mcp-baepsae
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/oozoofrog/mcp-baepsae/.github/workflows/release.yml@refs/tags/v6.3.0
- Rekor log index:
- 1203861004
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:29f22643e7370220f5a829531ded8c15e3943c29563218989756e433eb0a034eb1a2269c724f7f70ce7bb983b9893d5a7fc65f9cef4c0542128be6576
- Discovery method:
- attestation_endpoint
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| postinstall | unreviewed | if [ "$(uname)" = "Darwin" ]; then if [ -f bundled/baepsae-native ] && bundled/baepsae-native --version >/dev/null 2>&1; then exit 0; fi; if command -v swift >/dev/null 2>&1; then npm run build:native; else echo 'WARNING: No working native binary and Swift not found. Native commands will be unavailable.' >&2; fi; fi |
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
activate_app ~65
Bring the target app to foreground.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
analyze_ui ~272
Describe app UI hierarchy. Works with both simulator (udid) and macOS (bundleId/appName) targets.
| Name | Type | Req | Description |
|---|---|---|---|
| all | boolean | — | Include all elements (system UI, bezels) |
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| focusId | string | — | Focus on element with specific ID |
| limit | integer | — | Maximum number of nodes to return |
| maxDepth | integer | — | Maximum tree traversal depth |
| offset | integer | — | Pagination start position (0-based node index) |
| output | string | — | Optional output file path for hierarchy text |
| page | integer | — | Page number (0-based) |
| pageSize | integer | — | Page size for paginated child access |
| role | string | — | Filter by AX role (e.g. AXButton, AXStaticText) |
| rootElementId | string | — | Only traverse subtree under this element ID |
| summary | boolean | — | Summary mode — collapse children as [N children] |
| udid | string | — | Simulator UDID (for simulator targets) |
| visibleOnly | boolean | — | Only include visible elements |
| window | — | — | Window index or title substring (macOS only) |
No output schema declared.
No examples provided.
baepsae_help ~39
Show help. Optionally pass subcommand name for compatibility reference.
| Name | Type | Req | Description |
|---|---|---|---|
| subcommand | string | — | Optional legacy subcommand name for compatibility reference |
No output schema declared.
No examples provided.
baepsae_version ~17
Show server and native binary versions.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
button ~45
Press a simulator hardware button.
| Name | Type | Req | Description |
|---|---|---|---|
| buttonType | string | yes | Button type |
| duration | number | — | Hold duration in seconds |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
clipboard ~40
Read or write the system clipboard.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Read or write clipboard |
| text | string | — | Text to write (required for write action) |
No output schema declared.
No examples provided.
context_menu_action ~112
Select an item from an open context menu. Call after right_click. Supports submenu paths with > separator (e.g. 'Refactor > Rename').
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| item | string | yes | Context menu item path (e.g. 'Copy', 'Refactor > Rename') |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
detect_dialog ~88
Detect if a modal dialog, sheet, or alert is currently presented. Returns JSON with hasDialog, type, title, isModal, and buttons.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
doctor ~31
Run readiness self-checks for host process, parent process, native binary, booted simulator availability, and accessibility permission.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
drag_drop ~130
Drag and drop in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| duration | number | — | Duration in seconds |
| endX | number | yes | End X |
| endY | number | yes | End Y |
| holdDuration | number | — | Hold duration before drag in seconds |
| startX | number | yes | Start X |
| startY | number | yes | Start Y |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
enumerate_ui ~98
Discover all attributes, actions, and parameterized attributes of a UI element. Shows which attributes are settable.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| id | string | — | Accessibility identifier |
| label | string | — | Accessibility label |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
focus_window ~96
Raise and focus a specific window by index or title. macOS apps only.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| index | integer | — | Window index (0-based) |
| title | string | — | Window title substring |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
gesture ~94
Execute a preset gesture pattern.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | — | Gesture duration in seconds |
| postDelay | number | — | Delay after gesture in seconds |
| preDelay | number | — | Delay before gesture in seconds |
| preset | string | yes | Gesture preset |
| screenHeight | number | — | Screen height in points |
| screenWidth | number | — | Screen width in points |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
get_focused_app ~20
Get information about the currently focused macOS app.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
hit_test ~58
Find which UI element is at specific screen coordinates. Uses system-wide accessibility hit testing. No app target needed.
| Name | Type | Req | Description |
|---|---|---|---|
| x | number | yes | Screen X coordinate (top-left origin) |
| y | number | yes | Screen Y coordinate (top-left origin) |
No output schema declared.
No examples provided.
input_source ~85
Get current keyboard input source or switch to a specific one. Call without sourceId to query current; with sourceId to switch. Uses CJKV workaround for Korean/Japanese/Chinese/Vietnamese.
| Name | Type | Req | Description |
|---|---|---|---|
| sourceId | string | — | Input source ID to switch to (e.g. 'com.apple.inputmethod.Korean.2SetKorean'). Omit to query current. |
No output schema declared.
No examples provided.
install_app ~47
Install an app (.app, .ipa) on the simulator.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to .app or .ipa file |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
key ~92
Press a single HID keycode in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| duration | number | — | Hold duration in seconds |
| keycode | — | yes | HID keycode (0-255) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
key_combo ~89
Press key combo in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| key | — | yes | Keycode to press while modifiers are held |
| modifiers | array | yes | Modifier keycodes |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
key_sequence ~91
Press multiple HID keycodes in sequence in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| delay | number | — | Delay between key presses in seconds |
| keycodes | — | yes | Key sequence |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
launch_app ~60
Launch an installed app on the simulator.
| Name | Type | Req | Description |
|---|---|---|---|
| args | array | — | Arguments to pass to the app |
| bundleId | string | yes | App Bundle Identifier |
| env | object | — | Environment variables |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
list_apps ~18
List running macOS applications with their bundle IDs.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_input_sources ~25
List all available keyboard input sources with their IDs, names, and active status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_simulators ~17
List available simulators using simctl.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_windows ~65
List windows in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
menu_action ~66
Execute a menu bar action in a macOS app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | — |
| bundleId | string | — | — |
| item | string | yes | Menu item name (e.g. 'Save') |
| menu | string | yes | Menu name (e.g. 'File') |
No output schema declared.
No examples provided.
open_url ~44
Open a URL in the simulator (e.g. Safari or deep link).
| Name | Type | Req | Description |
|---|---|---|---|
| udid | string | yes | Simulator UDID |
| url | string | yes | URL to open |
No output schema declared.
No examples provided.
query_ui ~135
Search app UI elements by text, identifier, or label. Works with both simulator and macOS targets.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| maxDepth | integer | — | Maximum tree traversal depth |
| query | string | yes | Text to search for |
| role | string | — | Filter by AX role (e.g. AXButton, AXStaticText) |
| udid | string | — | Simulator UDID (for simulator targets) |
| visibleOnly | boolean | — | Only include visible elements |
No output schema declared.
No examples provided.
read_ui_param ~128
Read parameterized accessibility attributes like text ranges, line numbers, and bounds.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| attribute | string | yes | Parameterized attribute to read |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| id | string | — | Accessibility identifier |
| label | string | — | Accessibility label |
| param | string | yes | Parameter value (for range types: 'location,length'; for index/line: number) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
read_ui_value ~108
Read value, selected text, or insertion point of a UI element via Accessibility API.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| attribute | string | — | Attribute to read (default: value) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| id | string | — | Accessibility identifier |
| label | string | — | Accessibility label |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
record_video ~58
Record simulator display directly with simctl recordVideo.
| Name | Type | Req | Description |
|---|---|---|---|
| durationSeconds | number | — | Requested recording duration in seconds (default: 10) |
| output | string | — | Output MOV file path |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
right_click ~116
Right-click in the target app. Selector lookup defaults to in-app content; set all=true for Simulator chrome UI.
| Name | Type | Req | Description |
|---|---|---|---|
| all | boolean | — | — |
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| id | string | — | — |
| label | string | — | — |
| udid | string | — | Simulator UDID (for simulator targets) |
| x | number | — | — |
| y | number | — | — |
No output schema declared.
No examples provided.
run_steps ~139
Execute ordered workflow steps using existing tap, type_text, key, swipe, and sleep behavior. Defaults to fail-fast; set continueOnError or continue_on_error to keep going after a failure.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| continueOnError | boolean | — | Continue executing later steps after a step fails |
| continue_on_error | boolean | — | Alias of continueOnError |
| steps | array | yes | Ordered steps to execute |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
screenshot ~40
Capture a screenshot from simulator display using simctl screenshot.
| Name | Type | Req | Description |
|---|---|---|---|
| output | string | — | Output PNG file path |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
screenshot_app ~77
Take a screenshot of the target app window.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| output | string | — | Output file path |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
scroll ~112
Send scroll wheel events to the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| deltaX | number | — | Horizontal scroll amount |
| deltaY | number | — | Vertical scroll amount |
| udid | string | — | Simulator UDID (for simulator targets) |
| x | number | — | X coordinate for scroll position |
| y | number | — | Y coordinate for scroll position |
No output schema declared.
No examples provided.
set_ui_value ~125
Set value, text selection range, or focus on a UI element via Accessibility API.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| attribute | string | yes | Attribute to set |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| id | string | — | Accessibility identifier |
| label | string | — | Accessibility label |
| udid | string | — | Simulator UDID (for simulator targets) |
| value | string | yes | Value to set (for selectedTextRange use 'location,length' format) |
No output schema declared.
No examples provided.
stream_video ~68
Capture a time-bounded simulator clip through the native stream-video shim.
| Name | Type | Req | Description |
|---|---|---|---|
| durationSeconds | number | — | Requested clip duration in seconds (currently used as a timeout budget) |
| output | string | — | Destination MOV file path for the captured clip |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
swipe ~141
Perform swipe gesture in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| duration | number | — | Duration in seconds |
| endX | number | yes | End X |
| endY | number | yes | End Y |
| postDelay | number | — | Delay after swipe in seconds |
| preDelay | number | — | Delay before swipe in seconds |
| startX | number | yes | Start X |
| startY | number | yes | Start Y |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
tap ~172
Tap coordinates or accessibility element. Selector lookup defaults to in-app content; set all=true to include Simulator chrome UI.
| Name | Type | Req | Description |
|---|---|---|---|
| all | boolean | — | Include Simulator app chrome/system UI for selector lookup |
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| double | boolean | — | Send double-click instead of single click |
| id | string | — | Accessibility identifier |
| label | string | — | Accessibility label |
| postDelay | number | — | Delay after tap in seconds |
| preDelay | number | — | Delay before tap in seconds |
| udid | string | — | Simulator UDID (for simulator targets) |
| x | number | — | X coordinate |
| y | number | — | Y coordinate |
No output schema declared.
No examples provided.
tap_tab ~168
Tap a tab in a tab bar by index. Prefers semantic descendants or top-row semantic proxy buttons when available, and falls back to geometry only when needed. Useful for SwiftUI TabView cases where tab buttons are not cleanly exposed.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| index | integer | yes | 0-based tab index to tap |
| postDelay | number | — | Delay after tap in seconds |
| preDelay | number | — | Delay before tap in seconds |
| tabCount | integer | — | Total number of tabs (auto-detected from tab bar children if omitted) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
terminate_app ~39
Terminate a running app on the simulator.
| Name | Type | Req | Description |
|---|---|---|---|
| bundleId | string | yes | App Bundle Identifier |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
touch ~118
Perform touch events in the target app.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| delay | number | — | Delay between down/up in seconds |
| down | boolean | — | Send touch down event |
| udid | string | — | Simulator UDID (for simulator targets) |
| up | boolean | — | Send touch up event |
| x | number | yes | X coordinate |
| y | number | yes | Y coordinate |
No output schema declared.
No examples provided.
type_text ~193
Type text into the target app. auto resolves to paste for all targets (more reliable for CJK and emoji); simulator paste uses the simulator pasteboard, macOS paste temporarily uses the host clipboard; keyboard types character-by-character.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| file | string | — | Path for file input |
| method | string | — | Input method: 'auto' = paste for all targets; 'paste' = clipboard; 'keyboard' = char-by-char CGEvent; 'ax' = set value via Accessibility API (most reliable for CJK, bypasses IME) |
| stdinText | string | — | Text piped to stdin mode |
| text | string | — | Text argument |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
uninstall_app ~45
Uninstall an app from the simulator.
| Name | Type | Req | Description |
|---|---|---|---|
| bundleId | string | yes | App Bundle Identifier (e.g. com.example.app) |
| udid | string | yes | Simulator UDID |
No output schema declared.
No examples provided.
wait_for_ui ~144
Wait for a UI element to appear or disappear. Polls query_ui at interval until condition met or timeout.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| condition | string | — | Wait condition (default: exists) |
| interval | number | — | Poll interval in seconds (default: 0.5) |
| query | string | yes | Text/ID/label to search for |
| timeout | number | — | Max wait time in seconds (default: 10) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.
watch_notification ~164
Watch for AX notifications from an app. Blocks until a notification fires or timeout. Use presets for common patterns: window (created/destroyed), text (value/selection changed), focus (app/window focus), menu (opened/closed).
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | — | macOS app name (for macOS targets) |
| bundleId | string | — | macOS app bundle ID (for macOS targets) |
| notifications | string | — | Comma-separated notification names (e.g. 'AXValueChanged,AXWindowCreated') |
| preset | string | — | Notification preset (window, text, focus, menu) |
| timeout | number | — | Max wait time in seconds (default: 10) |
| udid | string | — | Simulator UDID (for simulator targets) |
No output schema declared.
No examples provided.