computer-use

Automates desktop GUI interactions via accessibility-tree element indexing across macOS, Windows, and Linux.

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill computer-use-maopujie10-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: computer-use
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/computer-use
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill computer-use-maopujie10-sys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Driving a user's desktop applications normally requires moving the real cursor and stealing keyboard focus, which interrupts the user's own work. This Skill lets an agent click, type, scroll, and drag in the background using accessibility-tree element indices instead of fragile pixel coordinates, on any major desktop platform. ## Core Features & Use Cases - Background GUI automation: Click, double-click, drag, scroll, type, and send keyboard shortcuts without raising windows, moving the OS cursor, or switching virtual desktops. - Element-index targeting: Capture screenshots with numbered overlays plus an accessibility-tree index, then act on elements by index for far higher reliability than raw coordinates. - Cross-platform support: Works on macOS (AX), Windows (UIA), and Linux (AT-SPI) with platform-appropriate keyboard shortcuts and failure-mode guidance. - Use Case: Ask the agent to fill out a form in a native desktop app like Mail or Figma while you keep typing in your editor; the agent captures the app, clicks fields by element index, and verifies each step with follow-up captures. ## Quick Start Ask the agent to capture the screen of a specific app and click a named button in it using the computer_use tool.

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 action capture to get a screenshot with numbered element overlays, then call click with the element index. Input is routed in the background, so the real OS cursor and keyboard focus are never disturbed.

How to click GUI elements reliably with an AI agent?

Capture the target app in SOM mode to receive an accessibility-tree index of interactable elements, then reference elements by their index number instead of pixel coordinates. Re-capture before each click because indices become stale after any new capture.

Does computer-use work on Windows, macOS, and Linux?

Yes, it supports all three platforms through cua-driver, using AX on macOS, UIA on Windows, and AT-SPI on Linux. Keyboard shortcuts differ per platform, such as cmd+s on macOS versus ctrl+s on Windows and Linux.

Why did my element click fail or target the wrong element?

Element indices are only valid until the next capture, so a stale index causes an explicit error rather than a wrong click. Re-capture the app, check for blocking modals, and dismiss them before retrying the action.

When should I use browser tools instead of computer-use?

Use browser automation tools for web tasks because they drive a headless Chromium more reliably than a GUI browser. Reserve computer_use for native applications like Finder, Mail, Figma, or games that browser tools cannot reach.