---
title: agent-desktop
description: Operate native Linux desktop apps through their accessibility trees in an eve sandbox.
url: "https://eve.dev/integrations/agent-desktop"
docs_index: /llms.txt
type: extension
keywords:
  - desktop automation
  - computer use
  - accessibility
  - Linux
---

> For an index of all documentation, see [/llms.txt](/llms.txt).

Extension integration for eve. Operate native Linux desktop apps through their accessibility trees in an eve sandbox.

## Install

Install the experimental agent-desktop extension in your eve project:

```bash
eve add extension/agent-desktop
```

Use an Ubuntu 24.04 or later sandbox with apt and root or passwordless sudo.

## Quick start

The command creates `agent/extensions/desktop.ts`. Before using the tools, call `installAgentDesktop` from `@eve/agent-desktop/sandbox` in your sandbox environment's `prepare` callback. Include `AGENT_DESKTOP_REVALIDATION_KEY` in the environment options so eve rebuilds the template when desktop dependencies change.

The extension adds `desktop__launch`, `desktop__snapshot`, and other tools. The tools start the desktop when needed, but do not install dependencies at tool time.

## Configure

Follow the [desktop sandbox setup](/docs/extensions#accessibility-based-desktop-tools) to install the apps the agent should operate. Accessibility actions are headless by default; enable `headed` only if the agent should be allowed to move the pointer or change focus.

[Read the full extension documentation](/docs/extensions#accessibility-based-desktop-tools)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)