> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/ericclemmons/agent-native/llms.txt
> Use this file to discover all available pages before exploring further.
# Command reference
> Complete reference of all agent-native CLI commands
Complete reference for all commands in the agent-native CLI toolkit.
## Discovery commands
### apps
List all running GUI applications.
```bash theme={null}
agent-native apps [--format text|json]
```
Output format
**Example:**
```bash theme={null}
agent-native apps
```
***
### find
Find accessibility elements matching filters.
```bash theme={null}
agent-native find [OPTIONS]
```
Application name
Filter by role (e.g., AXButton, AXTextField)
Filter by title (substring match)
Filter by label (substring match)
Filter by identifier (substring match)
Filter by value (substring match)
Maximum search depth
Maximum results to return
Output format
**Example:**
```bash theme={null}
agent-native find Safari --role AXButton --title "New Tab"
```
***
### tree
Print the accessibility tree for an application.
```bash theme={null}
agent-native tree [OPTIONS]
```
Application name
Maximum tree depth
Output format
**Example:**
```bash theme={null}
agent-native tree Calculator --depth 3
```
***
### snapshot
Create an accessibility tree snapshot with interactive references (@n1, @n2, etc.).
```bash theme={null}
agent-native snapshot [OPTIONS]
```
Application name
Show only interactive elements (buttons, text fields, etc.)
Remove empty structural elements
Maximum tree depth
JSON output
**Example:**
```bash theme={null}
agent-native snapshot Calculator --interactive
```
The snapshot command generates `@n1`, `@n2`, etc. references that can be used with other commands like `click`, `fill`, and `get`.
***
### inspect
Inspect all attributes and actions of an element.
```bash theme={null}
agent-native inspect [OPTIONS]
```
Target element: `@ref` or app name
Filter by role
Filter by title
Filter by label
Filter by identifier
Which match (0-indexed)
JSON output
**Example:**
```bash theme={null}
agent-native inspect @n5
agent-native inspect Calculator --role AXButton --title "5"
```
## Application commands
### open
Open or launch an application.
```bash theme={null}
agent-native open [OPTIONS]
```
Application name or bundle identifier
Output format
**Example:**
```bash theme={null}
agent-native open Calculator
agent-native open com.apple.calculator
```
***
### screenshot
Capture a screenshot of an app's frontmost window.
```bash theme={null}
agent-native screenshot [path] [OPTIONS]
```
Application name or bundle identifier
Output path (defaults to auto-generated temp file)
JSON output
**Example:**
```bash theme={null}
agent-native screenshot Safari ~/Desktop/safari.png
```
## Interaction commands
### click
Click an element (performs AXPress action).
```bash theme={null}
agent-native click [OPTIONS]
```
Target element: `@ref` or app name
Filter by role
Filter by title
Filter by label
Filter by identifier
Which match (0-indexed)
JSON output
**Examples:**
```bash theme={null}
agent-native click @n5
agent-native click Calculator --role AXButton --title "5"
```
***
### fill
Clear a text field and type new text.
```bash theme={null}
agent-native fill [OPTIONS]
```
Target element: `@ref` or app name
Text to fill
Filter by role
Filter by title
Filter by label
Which match (0-indexed)
JSON output
**Examples:**
```bash theme={null}
agent-native fill @n3 "hello world"
agent-native fill TextEdit --role AXTextArea "Document content"
```
***
### type
Type text into an element without clearing existing content.
```bash theme={null}
agent-native type [OPTIONS]
```
Target element: `@ref` or app name
Text to type
Filter by role (defaults to TextField)
Filter by title
Filter by label
Filter by identifier
Which match (0-indexed)
JSON output
**Example:**
```bash theme={null}
agent-native type @n7 "additional text"
```
***
### focus
Focus an element.
```bash theme={null}
agent-native focus [OPTIONS]
```
Target element: `@ref` or app name
Filter by role
Filter by title
Filter by label
Filter by identifier
Which match (0-indexed)
JSON output
**Example:**
```bash theme={null}
agent-native focus @n2
```
***
### hover
Hover over an element (moves cursor to center).
```bash theme={null}
agent-native hover [OPTIONS]
```
Target element: `@ref` or app name
Filter by role
Filter by title
Filter by label
Which match (0-indexed)
JSON output
**Example:**
```bash theme={null}
agent-native hover @n8
```
***
### check
Check a checkbox or toggle (idempotent).
```bash theme={null}
agent-native check [OPTIONS]
```
Target element: `@ref` or app name
Filter by role (defaults to CheckBox)
Filter by title
Filter by label
Which match (0-indexed)
JSON output
**Example:**
```bash theme={null}
agent-native check @n12
agent-native check "System Settings" --title "Show scroll bars"
```
***
### uncheck
Uncheck a checkbox or toggle (idempotent).
```bash theme={null}
agent-native uncheck [OPTIONS]
```
Target element: `@ref` or app name
Filter by role (defaults to CheckBox)
Filter by title
Filter by label
Which match (0-indexed)
JSON output
**Example:**
```bash theme={null}
agent-native uncheck @n12
```
***
### select
Select an option from a popup button or combo box.
```bash theme={null}
agent-native select