GZFastCUA
← Main site

Open source · Local first · Computer use runtime

Less waiting.
More doing.

FastCUA is a fast, reliable, and controllable local execution layer for computer-use agents. It brings interface state, native input, access policy, and human takeover into one resident control plane.

Role
Execution runtime
Interface
MCP / host protocol
Current host
Windows 11 x64
License
Apache-2.0
Agent / MCP ClientFastCUA RuntimeNative Host AdapterComputer
§ Why FastCUA

Use the right layer
for the right job.

FastCUA does not replace browser automation. It covers the Windows layer around it: applications, system dialogs, browser chrome, and workflows that cross app boundaries.

Vision-first Computer UseBrowser bridge / extensionFastCUA
Control scopeWhat appears in screenshotsWeb pages inside the browserDesktop applications and browser windows
Primary navigationPixels and coordinatesDOM · CDP · Browser APIsUI Automation text; screenshots when needed
Model requirementUsually needs visionUsually text is enoughText-only or vision-capable
Execution patternOften one action per loopBrowser commandsMultiple native actions per model turn
Human takeoverVariesUsually limited to browserGlobal pause, approval, interjection, and exit
§ Principles · 03

Speed comes from execution,
not marketing numbers.

FastCUA shortens the round-trip between an agent and a computer. This page describes mechanisms already present in the code—no invented product interface.

  1. P-01
    Observe

    Structured first, vision when needed

    When accessibility information can express an interface accurately, read text and control structure directly. Request screenshots for canvases, custom controls, or visual verification.

    01
  2. P-02
    Persist

    One warm control plane

    Clients share a resident native host. Window identity, pointer state, approvals, pauses, and interruptions are not rebuilt for every individual action.

    02
  3. P-03
    Execute

    Many actions per model turn

    Stable clicks, keys, text input, scrolling, and drags can run in sequence. Observe again when layout, focus, or modal state changes.

    03
§ You stay in control

Visible when it matters.
Interruptible at any time.

Safe mode is the default. Trusted applications can run directly; unknown applications require a decision. Full access is separate, visible, and reversible.

Active

Compact island + screen border

The AI is using the computer; the border remains click-through.

Approval

Allow once, trust, or deny

Unknown applications cannot launch silently in safe mode.

Full access

Visible and reversible

Per-app prompts are disabled only while this mode remains on.

Paused

New actions are blocked

Resume in one step or take over the mouse directly.

Four global controls
F7Pause + open control center
F8Pause / resume
F9Expand island + interject
F10Exit FastCUA completely

Global keys remain available while the agent owns the pointer. Clicking the island also pauses and opens the control center.

§ More than a mouse script

A coherent control plane,
not a pile of clicks.

01

Window-aware coordinates

Actions stay attached to the target window and account for DPI scaling.

02

Text and pixels are independent

Request interface text, a screenshot, or both according to the next decision.

03

Native input

Clicks, key chords, Unicode text, scrolling, drag, and value replacement.

04

Two-way interruption

A person can pause or redirect; approval waiting also pauses the machine.

05

Exact trust rules

Canonical paths and executable names are matched exactly—never unsafe substrings.

06

Local first

MCP uses a named pipe, the console binds to 127.0.0.1, and policy stays on the PC.

§ Architecture

Platform capability stays in adapters.
Control semantics stay in the runtime.

A-01Clients

MCP-compatible Agents · Custom Clients

stdio MCP
A-02FastCUA Runtime

state · policy · approvals · interruption

control semantics
A-03Host adapters

Native platform integration

current: Windows 11 x64

The runtime defines consistent control semantics; host adapters provide windows, input, and platform APIs. Current release scope and future architecture boundaries remain separate.

§ Boundaries

What it is—and what
the current release is not.

FastCUA is
  • An open-source, local-first computer-use execution runtime
  • An MCP tool layer for text-only and vision-capable models
  • A control plane with pause, approval, and human takeover
The current release is not
  • A complete cross-platform release package
  • A replacement for DOM, CDP, or every specialized automation tool
  • A way around UAC, secure desktops, or authentication surfaces
§ Real-world demo

Real footage.
No concept mockups.

The Bilibili field-test video will show the complete path from task instruction and interface observation to execution and human takeover.

Video in preparation

BILIBILI TEST VIDEO

COMING SOON
§ Release · v0.1.1

Bring your own agent.

The installer prepares Node.js and the verified FastCUA runtime. It does not install, select, or modify an AI client.

irm https://raw.githubusercontent.com/Guojiz/FastCUA/main/install.ps1 | iex
01 · Install runtime02 · Open FastCUA Agent Setup.txt03 · Give it to any MCP-compatible agent

The agent reads the bundled skill, configures its own stdio MCP connection, and verifies FastCUA. No specific agent is required.