double-click

​

Overview

​

Syntax

agent-desktop double-click <ref>

​

Parameters

​

Response

{
  "version": "1.0",
  "ok": true,
  "command": "double-click",
  "data": {
    "action": "double_click",
    "ref_id": "@e8"
  }
}

​

Response Fields

​

AX-First Strategy

1. Native double-click action if exposed via AX
2. Two rapid kAXPressAction calls
3. Mouse double-click at element center

​

Usage Examples

​

Open a File in Finder

agent-desktop snapshot --app Finder -i
agent-desktop find --role "cell" --name "document.pdf"
agent-desktop double-click @e12

​

Select a Word in Text Editor

agent-desktop snapshot --app TextEdit -i
agent-desktop double-click @e4  # Double-click on word to select it
agent-desktop press cmd+c        # Copy selected text

​

Open Folder

agent-desktop snapshot --app Finder -i
agent-desktop find --role "cell" --name "Documents"
agent-desktop double-click @e5
agent-desktop wait 300
agent-desktop snapshot -i

​

Common Use Cases

• File Management: Open files and folders in Finder
• Text Selection: Select words in text fields and editors
• Desktop Icons: Launch applications from desktop
• List Items: Open items in list views

​

Error Cases

​

Notes

• Timing between clicks is platform-optimized (typically 200-300ms)
• Some apps may treat double-click as two single clicks
• Use triple-click for line/paragraph selection
• Always snapshot after double-click to capture resulting UI changes