LibreAI / AI Agents / agent-desktop
// agents · lahfir/agent-desktop

agent-desktop

Reliable computer use for any agent: drive real apps through accessibility trees, not pixel guessing.

★ 1.8k stars⑂ 127 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

agent-desktop is an open-source ai agents project by lahfir (lahfir/agent-desktop on GitHub). It has 1,778 GitHub stars and 127 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 6 October 2026.

GitHub stars
1,778
Forks
127
License
Apache-2.0
Last updated on GitHub
6 October 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide which desktop workflow your agent must perform and which apps it involves.

  2. Get the project

    Install agent-desktop globally from npm, or build it from source with cargo.

  3. Install and configure

    Grant macOS Accessibility permission (and Screen Recording if you need screenshots), using the built-in permission request command.

  4. Run your first task

    Take a snapshot of the target app, note element references, act on them, and re-snapshot to verify the result, optionally inside a traced session.

// features

Why people love it

Accessibility-tree snapshots with stable refs

Snapshots return compact element references tied to a snapshot id, so agents act on identified controls rather than screen coordinates.

Progressive skeleton traversal

Dense apps can be explored through a shallow skeleton overview with targeted drill-down, which the project says cuts snapshot token use dramatically.

Headless-by-default interaction

Reference-based actions use accessibility APIs and avoid silently stealing focus, cursor, keyboard, or clipboard.

Broad command surface

Dozens of commands cover observation, interaction, keyboard, mouse, notifications, clipboard, window management, sessions, and trace export, all with structured JSON output.

Chromium interop via CDP

Launching a Chromium app with CDP opens a verified DevTools port so Playwright, Puppeteer, or agent-browser can drive web content while native UI stays on the accessibility path.

Sessions, traces, and FFI bindings

Shared sessions give multi-agent workflows a common snapshot namespace and JSONL traces exportable as a single HTML viewer, and a C-ABI library supports in-process use from many languages.

Advertisement
// run it

Run it yourself

  1. Clone and build from source (alternative to npm)

    The npm install is the recommended route; source builds need Rust 1.89+ and macOS 13+.

    git clone https://github.com/lahfir/agent-desktop.git
    cd agent-desktop
    cargo build --release
  2. Install from npm and grant permissions

    The package downloads the prebuilt binary automatically.

    npm install -g agent-desktop
    agent-desktop permissions --request
  3. Snapshot and act

    List a Finder window's interactive elements, then click one by reference.

    agent-desktop snapshot --app Finder -i
    agent-desktop click @e3 --snapshot <snapshot_id>
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains it?

It is maintained by lahfir on GitHub.

Is it free to use?

Yes, it is Apache-2.0 licensed and free; the AI model that decides what to click comes from your own agent setup.

Does it need a paid API key?

Agent Desktop needs no API key; it is a local control tool. The agent driving it uses your existing model access.

How does it compare to a well-known alternative?

Screenshot-based computer use guesses coordinates from pixels and breaks when layouts shift; Agent Desktop reads the real accessibility tree and acts on stable element references that are safe to retry.

How do I get started?

Run npm install -g agent-desktop, grant Accessibility permission, then take your first snapshot with agent-desktop snapshot --app Finder -i.

// keep exploring

Similar tools

AI Agents

open-codex-computer-use

Open-source Computer Use as an MCP service: let any agent drive macOS, Linux, and Windows desktops.

★ 2.4k starsMIT
View guide →
AI Agents

ESP32 iPhone Agent

ESP32 iPhone Agent — let an AI model use a real iPhone with a $7 ESP32: AirPlay eyes, USB HID hands, no computer, no jailbreak

★ 2.4k starsMIT
View guide →
AI Agents

OSWorld-V2

Benchmark computer-use agents on long, real-world desktop tasks.

★ 353 starsApache-2.0
View guide →
AI Agents

mobile-use

AI agents that use real Android and iOS apps like a human — from minitap.

★ 3.2k starsApache-2.0
View guide →
AI Agents

pinvou-agent

Pinvou Agent — open-source desktop AI agent for tools, files, knowledge, workflows and real deliverables

★ 2.4k starsMIT
View guide →
AI Agents

LobsterAI

A desktop-grade AI agent from NetEase Youdao that does real work — analysis, slides, docs, video and research.

★ 6.1k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if agent-desktop is not the right fit.

Get agent-desktop

Free and open — grab the source, star the repo, and start creating.