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

agent-desktop

agent-desktop est un projet de agents IA open source, créé par lahfir (lahfir/agent-desktop sur GitHub). Il compte 1 778 étoiles sur GitHub et 127 forks, il est publié sous la licence Apache-2.0 et a été mis à jour pour la dernière fois sur GitHub le 6 octobre 2026.

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

★ 1,8 k étoiles⑂ 127 forksApache-2.0mis à jour oct. 2026
▦ visuel — le README de ce projet ne contient aucune capture intégrable,
voici donc un emplacement réservé. Le guide ci-dessous est complet malgré tout.
// détails du projet

Détails du projet

Étoiles GitHub
1 778
Forks
127
Licence
Apache-2.0
Dernière mise à jour sur GitHub
6 octobre 2026
Catégorie
Agents IA
Type de fiche
Guide d'installation complet
// fonctionnement

Comment ça marche

  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.

// fonctionnalités

Pourquoi on l'adore

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
// lancez-le

Lancez-le vous-même

  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>
// cas d'usage

Ce que vous pouvez créer

Advertisement
// faq

Questions fréquentes

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.

// continuez l'exploration

Outils similaires

Agents IA

open-codex-computer-use

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

★ 2,4 k étoilesMIT
Voir le guide →
Agents IA

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,4 k étoilesMIT
Voir le guide →
Agents IA

OSWorld-V2

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

★ 353 étoilesApache-2.0
Voir le guide →
Agents IA

mobile-use

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

★ 3,2 k étoilesApache-2.0
Voir le guide →
Agents IA

pinvou-agent

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

★ 2,4 k étoilesMIT
Voir le guide →
Agents IA

Jev Ultrafast

Jev Ultrafast — the fastest browser agent from browser-use: one decision-model request per action cycle drives a real browser, MIT

★ 23,7 k étoilesMIT
Voir le guide →
// alternatives

Alternatives en Agents IA

Les autres projets de la catégorie Agents IA avec le plus d'étoiles du catalogue LibreAI — la sélection réaliste d'alternatives si agent-desktop ne vous convient pas.

// plus en agents

Plus en Agents IA

Projets de la catégorie Agents IA proches dans le catalogue, les plus proches en étoiles de agent-desktop — continuez à explorer de part et d'autre.

Obtenir agent-desktop

Gratuit et ouvert : récupérez le code source, mettez une étoile au dépôt et commencez à créer.