# agent-native

## Docs

- [Best practices for AI agents](https://mintlify.wiki/ericclemmons/agent-native/ai/best-practices.md): Essential patterns and guidelines for reliable macOS automation with AI agents
- [JSON output mode](https://mintlify.wiki/ericclemmons/agent-native/ai/json-output.md): Using the --json flag for structured, parseable output from agent-native commands
- [OpenCode skill](https://mintlify.wiki/ericclemmons/agent-native/ai/opencode-skill.md): Pre-built skill file for integrating agent-native with OpenCode and other AI coding assistants
- [AI integration overview](https://mintlify.wiki/ericclemmons/agent-native/ai/overview.md): How agent-native is designed for AI agents and LLM automation workflows
- [Discovery commands](https://mintlify.wiki/ericclemmons/agent-native/commands/discovery.md): Find and explore UI elements in macOS applications
- [Interaction commands](https://mintlify.wiki/ericclemmons/agent-native/commands/interaction.md): Control macOS applications by clicking, typing, and manipulating UI elements
- [Keyboard commands](https://mintlify.wiki/ericclemmons/agent-native/commands/keyboard.md): Send keystrokes, shortcuts, and paste content to macOS applications
- [Commands overview](https://mintlify.wiki/ericclemmons/agent-native/commands/overview.md): Complete guide to agent-native CLI commands for macOS app automation
- [Screenshot command](https://mintlify.wiki/ericclemmons/agent-native/commands/screenshot.md): Capture images of application windows for documentation and testing
- [Snapshot command](https://mintlify.wiki/ericclemmons/agent-native/commands/snapshot.md): Create interactive element reference maps for agent automation
- [State commands](https://mintlify.wiki/ericclemmons/agent-native/commands/state.md): Read element properties, values, and attributes from macOS applications
- [Wait command](https://mintlify.wiki/ericclemmons/agent-native/commands/wait.md): Wait for UI elements to appear with configurable timeouts
- [Accessibility tree](https://mintlify.wiki/ericclemmons/agent-native/concepts/accessibility-tree.md): Understanding macOS Accessibility tree and how agent-native uses it
- [Refs and snapshots](https://mintlify.wiki/ericclemmons/agent-native/concepts/refs-and-snapshots.md): Understanding the ref system that makes element interactions possible
- [Workflow](https://mintlify.wiki/ericclemmons/agent-native/concepts/workflow.md): The snapshot → interact → re-snapshot pattern for agent-native automation
- [Working with Electron apps](https://mintlify.wiki/ericclemmons/agent-native/guides/electron-apps.md): Automate Electron apps like Slack, Discord, and VS Code using keyboard shortcuts and screenshots
- [Automating Safari](https://mintlify.wiki/ericclemmons/agent-native/guides/safari-automation.md): Navigate web pages and interact with web content in Safari using the Accessibility tree
- [Automating System Settings](https://mintlify.wiki/ericclemmons/agent-native/guides/system-settings.md): Complete walkthrough for navigating and configuring macOS System Settings
- [Troubleshooting](https://mintlify.wiki/ericclemmons/agent-native/guides/troubleshooting.md): Common errors, solutions, and debugging techniques for agent-native
- [Installation](https://mintlify.wiki/ericclemmons/agent-native/installation.md): Install agent-native on macOS and configure Accessibility permissions
- [Introduction](https://mintlify.wiki/ericclemmons/agent-native/introduction.md): Control macOS native apps via the Accessibility tree - like agent-browser, but for the desktop
- [Quick start](https://mintlify.wiki/ericclemmons/agent-native/quickstart.md): Complete tutorial from installation to your first macOS app automation
- [AX roles reference](https://mintlify.wiki/ericclemmons/agent-native/reference/ax-roles.md): Complete reference of macOS Accessibility roles for element filtering
- [Command reference](https://mintlify.wiki/ericclemmons/agent-native/reference/command-list.md): Complete reference of all agent-native CLI commands
- [Complete examples](https://mintlify.wiki/ericclemmons/agent-native/reference/examples.md): Real-world automation examples using agent-native