computer-use

Automates desktop GUI interactions via background clicks, typing, and scrolling across macOS, Windows, and Linux.

6|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/josoroma/AppLoop --skill computer-use-josoroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: computer-use
Source: https://github.com/josoroma/AppLoop/tree/main/.hermes/skills/autonomous-ai-agents/computer-use
Command: npx skills add https://github.com/josoroma/AppLoop --skill computer-use-josoroma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating tasks in native desktop applications normally requires stealing the user's cursor and keyboard focus, interrupting their work. This Skill drives the desktop in the background — clicking, typing, scrolling, and dragging — without moving the real cursor, switching virtual desktops, or raising windows, and it works with any tool-capable model. ## Core Features & Use Cases - Element-index targeting: Capture screenshots with numbered overlays and an accessibility-tree index, then click elements by index instead of unreliable pixel coordinates. - Verify-and-escalate ladder: Every input action returns a structured verdict (confirmed, unverifiable, suspected_noop) with recommended escalation from background input to pixel coordinates, typed browser-page routes, or foreground delivery. - Cross-platform support: Works on macOS (AX), Windows (UIA), and Linux (AT-SPI), with platform-specific keyboard shortcuts and failure diagnostics via hermes computer-use doctor. - Use Case: Ask the agent to fill out a form in a native desktop app like Figma or Mail while you keep typing in your editor — the agent captures the app, clicks fields by element index, types values, and verifies each step without ever taking your focus. ## Quick Start Ask the agent to open a specific desktop application and complete a task in it, such as clicking through a dialog or filling a form, while you continue working in another window.

Frequently Asked Questions about computer-use

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate desktop app clicks without moving the mouse cursor?▼

Use the computer_use tool with capture mode 'som' to get numbered element overlays, then call click with the element index. cua-driver delivers input in the background, so the real OS cursor never moves and focus stays with the user.

How to click UI elements reliably with an AI agent?▼

Capture the screen first to get an accessibility-tree index, then click by element number rather than pixel coordinates. Element indices are far more reliable across models, and you can add capture_after=True to verify the result in one call.

Does computer-use desktop automation work on Windows and Linux?▼

Yes, it supports macOS via the AX framework, Windows via UIA, and Linux via AT-SPI on X11 or Wayland. Platform differences like keyboard shortcuts and Session 0 isolation on Windows are documented in the cua-driver skill pack.

Why did my automated click have no effect on the desktop app?▼

Read the structured verdict returned by the action. An 'unverifiable' effect means re-capture before retrying, while 'suspected_noop' means escalate: try pixel coordinates, then the typed browser-page route, then delivery_mode foreground as a last resort.

When should I not use computer-use GUI automation?▼

Avoid it for web automation that headless browser tools can handle, for file edits better done with read_file or write_file, and for shell commands better run in a terminal. Reserve it for native apps like Finder, Mail, Figma, or games.