# agent-desktop

> AI agent tool for observing and controlling desktop applications via native OS accessibility trees

- **URL**: https://www.freshcrate.ai/projects/agent-desktop
- **Author**: lahfir
- **Category**: AI Agents
- **Latest version**: `v0.2.2` (2026-06-02)
- **License**: Apache-2.0
- **Source**: https://github.com/lahfir/agent-desktop
- **Language**: Rust
- **GitHub**: 69 stars, 9 forks
- **Registry**: npm (`agent-desktop`)
- **Tags**: `a11y`, `accessibility`, `agent`, `automation`, `cli`, `desktop`, `macos`, `npm`

## Description

AI agent tool for observing and controlling desktop applications via native OS accessibility trees

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.2.2` | 2026-06-02 | High | ## [0.2.2](https://github.com/lahfir/agent-desktop/compare/v0.2.1...v0.2.2) (2026-06-02)   ### Bug Fixes  * **macos:** guard CFArray casts with type-ID check (fixes Mail.app crash) ([#50](https://github.com/lahfir/agent-desktop/issues/50)) ([c02cb5e](https://github.com/lahfir/agent-desktop/commit/c02cb5ecb7314f053d63937437e5f5ba48de3209)) |
| `v0.2.1` | 2026-05-23 | High | ## [0.2.1](https://github.com/lahfir/agent-desktop/compare/v0.2.0...v0.2.1) (2026-05-23)   ### Bug Fixes  * stabilize empty accessibility identity refs ([1fb5a7d](https://github.com/lahfir/agent-desktop/commit/1fb5a7d51eb798100b4d597c755fee1161e298bf)) |
| `v0.2.0` | 2026-05-20 | High | ## [0.2.0](https://github.com/lahfir/agent-desktop/compare/v0.1.14...v0.2.0) (2026-05-20)   ### ⚠ BREAKING CHANGES  * chain execution deadlines now return TIMEOUT instead of ACTION_FAILED when the target app does not respond before the chain deadline.  ### Refactoring  * unify command execution contracts ([1291a9c](https://github.com/lahfir/agent-desktop/commit/1291a9cdbf0566424d38da1eab397d6d4091c06c)) |
| `v0.1.14` | 2026-05-04 | High | ## [0.1.14](https://github.com/lahfir/agent-desktop/compare/v0.1.13...v0.1.14) (2026-05-04)   ### Features  * bundle skill docs and refactor --help for AI agents ([#36](https://github.com/lahfir/agent-desktop/issues/36)) ([b04d6f9](https://github.com/lahfir/agent-desktop/commit/b04d6f97317af67648890d2d3b5ead0d27c466c9)) |
| `0.1.13` | 2026-04-21 | Low | Imported from npm (0.1.13) |
| `v0.1.13` | 2026-04-17 | High | ## Credits  The C-ABI FFI layer was originally proposed by [@jkroso](https://github.com/jkroso) in [#22](https://github.com/lahfir/agent-desktop/pull/22). This release is the hardened, reviewed, and shippable form of that idea — thanks Jake.  ---  ## [0.1.13](https://github.com/lahfir/agent-desktop/compare/v0.1.12...v0.1.13) (2026-04-17)   ### Features  * **ffi:** ship C-ABI cdylib with review hardening and release pipeline ([#26](https://github.com/lahfir/agent-desktop/issues/26)) ([3cffbd6](ht |
| `v0.1.13` | 2026-04-17 | High | ## Credits  The C-ABI FFI layer was originally proposed by [@jkroso](https://github.com/jkroso) in [#22](https://github.com/lahfir/agent-desktop/pull/22). This release is the hardened, reviewed, and shippable form of that idea — thanks Jake.  ---  ## [0.1.13](https://github.com/lahfir/agent-desktop/compare/v0.1.12...v0.1.13) (2026-04-17)   ### Features  * **ffi:** ship C-ABI cdylib with review hardening and release pipeline ([#26](https://github.com/lahfir/agent-desktop/issues/26)) ([3cffbd6](ht |
| `v0.1.13` | 2026-04-17 | High | ## Credits  The C-ABI FFI layer was originally proposed by [@jkroso](https://github.com/jkroso) in [#22](https://github.com/lahfir/agent-desktop/pull/22). This release is the hardened, reviewed, and shippable form of that idea — thanks Jake.  ---  ## [0.1.13](https://github.com/lahfir/agent-desktop/compare/v0.1.12...v0.1.13) (2026-04-17)   ### Features  * **ffi:** ship C-ABI cdylib with review hardening and release pipeline ([#26](https://github.com/lahfir/agent-desktop/issues/26)) ([3cffbd6](ht |
| `v0.1.13` | 2026-04-17 | Medium | ## Credits  The C-ABI FFI layer was originally proposed by [@jkroso](https://github.com/jkroso) in [#22](https://github.com/lahfir/agent-desktop/pull/22). This release is the hardened, reviewed, and shippable form of that idea — thanks Jake.  ---  ## [0.1.13](https://github.com/lahfir/agent-desktop/compare/v0.1.12...v0.1.13) (2026-04-17)   ### Features  * **ffi:** ship C-ABI cdylib with review hardening and release pipeline ([#26](https://github.com/lahfir/agent-desktop/issues/26)) ([3cffbd6](ht |
| `v0.1.13` | 2026-04-17 | Medium | ## Credits  The C-ABI FFI layer was originally proposed by [@jkroso](https://github.com/jkroso) in [#22](https://github.com/lahfir/agent-desktop/pull/22). This release is the hardened, reviewed, and shippable form of that idea — thanks Jake.  ---  ## [0.1.13](https://github.com/lahfir/agent-desktop/compare/v0.1.12...v0.1.13) (2026-04-17)   ### Features  * **ffi:** ship C-ABI cdylib with review hardening and release pipeline ([#26](https://github.com/lahfir/agent-desktop/issues/26)) ([3cffbd6](ht |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 0
- **Resolved**: 0
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-05-11

## Citation

- HTML: https://www.freshcrate.ai/projects/agent-desktop
- Markdown: https://www.freshcrate.ai/projects/agent-desktop.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/agent-desktop/deps

_Generated by freshcrate.ai. Indexes npm releases for AI-agent ecosystem packages._
