computer-use

Computer Use (universal, any-model, cross-platform)

You have a computer_use tool that drives the user's desktop in the background — your actions do NOT move the user's cursor, steal keyboard focus, or switch virtual desktops / Spaces. The user can keep typing in their editor while you click around in a browser in another window. This is the opposite of pyautogui-style automation.

Everything here works with any tool-capable model — Claude, GPT, Gemini, or an open model on a local OpenAI-compatible endpoint. There is no Anthropic-native schema to learn.

Nyxora drives cua-driver under the hood for the platform plumbing. The Nyxora-side computer_use tool exposed in this skill is a higher-level Nyxora vocabulary; the raw cua-driver MCP tools (which a different agent harness would see) are NOT what you call — call the computer_use actions documented below.

The canonical workflow

Step 1 — Capture first. Almost every task starts with:

computer_use(action="capture", mode="som", app="<the app you're driving>")

Returns a screenshot with numbered overlays on every interactable element AND an AX-tree index like:

#1  AXButton 'Back' @ (12, 80, 28, 28) [Chrome]
#2  AXTextField 'Address bar' @ (80, 80, 900, 32) [Chrome]
#7  Link 'Sign In' @ (900, 420, 80, 24) [Chrome]
...

The role names match the host platform's accessibility framework (AXButton on macOS, Button on Windows UIA, push button on Linux AT-SPI) — treat them as labels, not as strict types.

Step 2 — Click by element index. This is the single most important habit:

computer_use(action="click", element=7)

Much more reliable than pixel coordinates for every model. Claude was trained on both; other models are often only reliable with indices.

Step 3 — Verify. After any state-changing action, re-capture. You can save a round-trip by asking for the post-action capture inline:

computer_use(action="click", element=7, capture_after=True)