trycua--cua
wehub-resource-sync
91e75e620b
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Has been cancelled
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Has been cancelled
CD: Docs MCP Server / build (linux/amd64) (push) Has been cancelled
CD: Docs MCP Server / build (linux/arm64) (push) Has been cancelled
CD: Docs MCP Server / merge (push) Has been cancelled
CI: cua-driver distro-compat matrix / Resolve release version (push) Has been cancelled
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Has been cancelled
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Has been cancelled
CI: cua-driver distro-compat matrix / Distro compat summary (push) Has been cancelled
CI: Rust Linux unit / Rust Linux unit and compile (push) Has been cancelled
CI: Rust Windows unit / Rust Windows unit and compile (push) Has been cancelled
CI: Nix Linux Rust source / Nix / compositor build (push) Has been cancelled
CI: Nix Linux Rust source / Nix / driver package (push) Has been cancelled
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Has been cancelled
46 行
2.0 KiB
Markdown
46 行
2.0 KiB
Markdown
# Cua Driver
|
|
|
|
Background computer-use driver for any agents. Speaks MCP over stdio; drives native macOS apps without stealing focus.
|
|
|
|
**[Documentation](https://cua.ai/docs/cua-driver)** - Installation, guides, and API reference.
|
|
|
|
## Repository Layout
|
|
|
|
| Path | Purpose |
|
|
| --- | --- |
|
|
| `rust/` | Cargo workspace for the driver daemon, platform crates, and Rust tests |
|
|
| `python/` | Python package wrapper and package tests |
|
|
| `tests/fixtures/` | Source-built GUI harness apps and shared fixtures |
|
|
| `rust/crates/cua-driver/tests/` | Rust integration tests for the driver and GUI harnesses |
|
|
| `scripts/` | Install, uninstall, local build, and VM sync helpers |
|
|
| `docs/` | Small repo-local specs that are not part of the hosted docs site |
|
|
|
|
Start with `rust/README.md`, `rust/crates/cua-driver/tests/README.md`, and
|
|
`tests/fixtures/README.md` when changing driver behavior or tests.
|
|
|
|
Contributor documentation:
|
|
|
|
- `docs/test-matrix.md` maps unit and canonical harness E2E suites.
|
|
- `docs/action-support.md` is the empirical platform behavior ledger.
|
|
- `docs/test-harnesses-guide.md` explains fixture and runner ownership.
|
|
- `docs/linux-desktop-validation.md` covers representative Linux sessions.
|
|
- `docs/linux-support-completion-plan.md` preserves the historical Linux plan.
|
|
|
|
## Claude Code computer-use compatibility
|
|
|
|
Standard Claude Code MCP registration:
|
|
|
|
```bash
|
|
claude mcp add --transport stdio cua-driver -- cua-driver mcp
|
|
```
|
|
|
|
If you want Claude Code's vision/computer-use-style flow to ground on CuaDriver window screenshots, register the compatibility mode:
|
|
|
|
```bash
|
|
claude mcp add --transport stdio cua-computer-use -- cua-driver mcp --claude-code-computer-use-compat
|
|
```
|
|
|
|
This keeps CuaDriver's normal MCP tools and changes only `screenshot`, which requires `pid` and `window_id` and captures that window only.
|
|
|
|
Use MCP for this Claude Code vision/computer-use-style path. CLI screenshots still work as CuaDriver calls, but they do not expose the `mcp__cua-computer-use__screenshot` tool name that Claude Code appears to use as the image-grounding cue.
|