Lifan Chen faster-mac-use v0.1.0 · MIT

Background computer use for macOS that never touches your cursor.

Drive unfocused Chrome "🤖 Agent" tab groups and native macOS apps in parallel—at 0.0 px drift and 114× fewer tokens.

uvx faster-mac-use mcp
50Hz CoreGraphics guard: 0.0 px drift · 0 focus switches

One 268-token tool across Chrome and macOS.

Coordinate unfocused browser tabs and background macOS apps in a single stateful cua_repl turn while you keep working in the foreground.

Stateful multi-cursor execution

          
Isolated Virtual Cursors & Diff Output 0.0 px physical drift

Built for background isolation and sub-millisecond diffs.

Standard MCP loops grow quadratically because every click dumps a full accessibility tree. faster-mac-use collapses turn count and shrinks every observation to a compact UID delta.

Chrome "🤖 Agent" Tab Groups

Drive logged-in Chrome sessions or headless workers without stealing window focus.

  • Outbound MV3 WebSocket bridge avoids Chrome 144 debug modals.
  • Persistent @u1..@uN UIDs with pre-registered table row folding.
  • Auto-executes W3C WebMCP tools and reusable ~/.fmu/macros/.
  • Zero-dialog CDP file uploads and <canvas> Vision OCR.

Native Swift AXObserver & OCR

Persistent universal2 Swift daemon (/tmp/fmu-ax.sock) with a 4,000-node LRU cache.

  • Push-based AXObserver dirty tracking returns diffs in <1 ms.
  • Dispatches AXPress and background PID keys without focus theft.
  • Never overwrites NSPasteboard when setting native text fields.
  • Apple Silicon Vision.framework reads windows at 0 vision tokens.

3-Cursor Parallel Swarms

Run concurrent agents inside one runtime with isolated virtual cursors.

  • Concurrent {"parallel": [...]} swarms span Web and macOS.
  • Per-agent virtual cursors prevent physical click collisions.
  • Stale snapshots compress into 18-token history tombstones.
  • 50Hz CoreGraphics guard verifies 0.0 px physical cursor drift.
macOS 14+ & Accessibility
The compiled Swift fmu-ax daemon and Apple Silicon Vision OCR require macOS with Accessibility permission granted to your terminal or IDE.
MV3 Extension vs. Headless
Driving visible Chrome "🤖 Agent" tab groups uses the included MV3 extension (ws://127.0.0.1:19222/ext); without it, fmu runs in a background Chromium worker.
Unminimized Window OCR
AXUIElement actions work on any background or minimized window, while app.ocr() requires the target window to be unminimized (it may stay occluded).

Add to your agent in 30 seconds.

Connect fmu to Claude Code, Cursor, OpenAI Codex CLI, or Antigravity via MCP, or invoke it directly from shell scripts.

mcp_config.json / .cursor/mcp.json