Troubleshooting

Accessibility access denied. Enable in System Settings > Privacy & Security > Accessibility

App not found: Slak

Ref @n42 not found. It may be stale. Re-snapshot to get fresh refs.

# Re-snapshot to get new refs
agent-native snapshot "System Settings" -i

# Now use the new refs
agent-native click @n5

# Take snapshot
agent-native snapshot App -i > /tmp/snap1.txt

# Interact with refs from snap1.txt
agent-native click @n5

# Re-snapshot after UI change
agent-native snapshot App -i > /tmp/snap2.txt

# Use refs from snap2.txt for next interactions
agent-native click @n10

Element not found: AXButton[@title="Submit"]

Action 'AXPress' failed on: /AXWindow/AXButton

Timeout: Element with title="Submit" not found after 5s

# Save to file
agent-native snapshot App > /tmp/full-tree.txt

# Search for your element
grep -i "keyword" /tmp/full-tree.txt

# View in editor
code /tmp/full-tree.txt

# Get JSON snapshot
agent-native snapshot App -i --json > snapshot.json

# Query with jq
cat snapshot.json | jq '.[] | select(.title == "Submit")'

# Extract specific ref
REF=$(cat snapshot.json | jq -r '.[] | select(.title == "Submit") | .ref')
agent-native click "@$REF"

# Before action
agent-native snapshot App -i > /tmp/before.txt

# Perform action
agent-native click @n5
sleep 1

# After action
agent-native snapshot App -i > /tmp/after.txt

# Compare
diff /tmp/before.txt /tmp/after.txt

# Capture current state
agent-native screenshot App /tmp/state1.png

# Perform actions
agent-native click @n5

# Capture after state
agent-native screenshot App /tmp/state2.png

# Compare visually
open /tmp/state1.png /tmp/state2.png

# Full element inspection
agent-native inspect @n10

# Or by filter
agent-native inspect App --title "Submit"

# Step 1: Open app
agent-native open App
echo "Opened app"
sleep 1

# Step 2: Snapshot
agent-native snapshot App -i > /tmp/snap.txt
echo "Snapshot captured"

# Step 3: Find element
REF=$(grep -i "submit" /tmp/snap.txt | grep -o 'ref=n[0-9]*' | sed 's/ref=//' | head -1)
echo "Found ref: @$REF"

# Step 4: Click
if [[ -n "$REF" ]]; then
  agent-native click "@$REF"
  echo "Clicked"
else
  echo "Element not found"
  exit 1
fi

#!/usr/bin/env bash
set -x  # Print commands as they execute
set -euo pipefail  # Exit on error

agent-native open App
agent-native snapshot App -i
agent-native click @n5

agent-native click @n5
sleep 0.5
agent-native fill @n10 "text"
sleep 0.3
agent-native click @n15

sw_vers -productVersion

# List running apps
agent-native apps

# Full tree snapshot
agent-native snapshot App > debug.txt

# Interactive elements only
agent-native snapshot App -i

# JSON output
agent-native snapshot App -i --json

# Find elements
agent-native find App --title "Submit"

# Inspect element
agent-native inspect @n10

# Check element state
agent-native is enabled @n10
agent-native is focused @n10

# Get element attributes
agent-native get text @n10
agent-native get value @n10

# Screenshot
agent-native screenshot App /tmp/debug.png

# Window title
agent-native get title App