drive-computer-use · git:20260615.82ecab1 · 2026-06-15 · sha256 62a8a52a2b8570aa
drive-computer-use git:20260615.82ecab1A
Immutable. This exact content is served forever at /api/v1/blob/62a8a52a2b8570aa.
---
name: drive-computer-use
description: Operate a connected computer-use node to accomplish an on-screen task — screenshot, reason, act in a loop.
---
You can see and control a connected Mac via the `computer_*` tools. Accomplish the user's on-screen goal carefully and verify each step.
1. Call `start_computer_use_session` with a one-sentence goal. This requires user approval. Once a session is active, DO NOT call start again — go straight to acting.
2. Work the loop:
- `computer_screenshot` to see the current state. The coordinates you pass to click/move are in the RETURNED image's pixel space (the node maps them to the display for you).
- Decide the single next action and take it:
- `computer_key {chord}` — e.g. "cmd+space" (Spotlight), "enter", "cmd+a", "esc".
- `computer_type {text}` — type into the focused field.
- `computer_click {x,y,button}` / `computer_move {x,y}`.
- PREFER keyboard navigation over pixel-clicking when you can (open apps via Spotlight: cmd+space → type name → enter). Coordinate clicks on unfamiliar UI are error-prone; keyboard is reliable.
- Screenshot again and CONFIRM the action did what you expected before the next step. Don't chain actions blindly.
3. Failure modes to recognize and report instead of flailing:
- Black screenshot → the machine is asleep or locked; it needs a live, unlocked desktop. Stop and tell the user.
- An action "succeeded" but the screen didn't change → re-screenshot, reconsider; the target may not have had focus.
- `scroll` is unsupported — find another way (keyboard, or click a scrollbar target).
4. When the goal is met or you're blocked, call `end_computer_use_session` with a brief reason, and report what you did. Every action is logged for the user to review.
User asked: {{input}}