ergou-yu

Quick Computer Use — Development skill for Claude Code

Development community

QCU (Quick Computer Use) — a faster computer-use skill that prefers the accessibility tree over screenshots.

How to install Quick Computer Use

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ergou-yu/quick-computer-use and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Quick Computer Use does

QCU (Quick Computer Use) — a faster computer-use skill that prefers the accessibility tree over screenshots. Web + macOS desktop automation.

Alternatives in Development

  • Claude Code Rust — 🚀 Rust 全量重构的 Claude Code - 性能提升 2.5x,体积减少 97% High-performance Rust implementation of Claude Code with 2.5x f 1.4k ★
  • Claude Keysmith — Managed Claude Code instruction deployment with safe CLI recovery and an unsigned macOS/Windows desktop beta 696 ★
  • Quick Eval — Quick job evaluation 473 ★

README

QCU — Quick Computer Use

**1.8.** QCU controls an explicitly selected browser page or desktop window with accessibility references. This revision binds references to a backend lifetime, target and observation; separates dispatch from verified results; and adds a minimal Windows UI Automation backend. **Windows 真机未验证.**

Install

Python 3.11+:

python -m pip install -e '.[dev]'        # web / development
python -m playwright install chromium   # web only
python -m pip install -e '.[macos,dev]'  # macOS AX

On Windows PowerShell:

py -m pip install -e ".[windows,dev]"
py scripts/verify_windows_uia.py

Platform extras use environment markers. Web/macOS installations do not import or install Windows UIA dependencies. See [INSTALL.md](INSTALL.md).

Target → observe → act → verify

qcu session start --context desktop
qcu observe --pid 12345 --window 'Fixture window' --compact
# Copy opaque refs from this observation. Example placeholder:
qcu act '{"type":"click","params":{"ref":"","verify":{"kind":"text","equals":"Saved 1"}}}'
qcu session end

For web use `session start --context web`, navigate, then observe. QCU Chromium has its own profile; it does not inherit the user's open authenticated tab. Preserve the selected target. Tests must use an independent `QCU_HOME`.

  • Explicit missing or ambiguous windows fail with diagnostics/candidates.
  • routing_meta.target identifies the app/window or browser tab.
  • Re-observe after a backend restart, target change or invalid reference. Old numeric and obs_N:ref_M tokens are not upgraded into new control identities.
  • Ref actions never become cached-coordinate actions. Coordinate/OCR paths must establish the same target; unavailable inspection stops them.
  • A successful call or changed interface is distinct from the requested result. Only outcome: verified confirms the specified postcondition.
  • batch permits 1–32 actions, fills before one final action, a