# Instrucciones para el agente: Agent Desktop: opera aplicaciones desde su árbol de accesibilidad

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/lahfir/agent-desktop (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/agent-desktop-cli

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba que tienes Node.js y npm para instalar el paquete. Para el ejemplo con Finder, usa macOS y concede Accesibilidad según la [guía oficial](https://github.com/lahfir/agent-desktop/blob/main/docs/install.md#permissions) antes de tomar la instantánea. En Linux, la guía apunta a Ubuntu 24.04+ con GNOME 46, glibc ≥2.35, `at-spi2-core` y una sesión gráfica; no basta una terminal SSH aislada.

### Paso 1: instala y consulta el estado

```bash
npm install -g agent-desktop
agent-desktop status
```

### Paso 2: carga las reglas de operación

```bash
agent-desktop skills get desktop
agent-desktop skills get platform
```

En macOS, abre una ventana de Finder y observa sus controles:

```bash
agent-desktop snapshot --app Finder -i
```

Usa únicamente referencias de tu propia instantánea para actuar.

## Comprobación

Comprueba que el estado reconoce la plataforma y sus permisos. La instantánea debe devolver controles de la ventana elegida. Después de una acción, toma otra instantánea para verificar el cambio.

## Si algo falla

En macOS consulta `agent-desktop permissions --guide`. En Linux comprueba la sesión gráfica y at-spi2-core. Si un control desaparece, vuelve a observar antes de reintentar.