# Instrucciones para el agente: Composio CLI: busca y ejecuta herramientas de aplicaciones conectadas

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/ComposioHQ/composio/tree/main/ts/packages/cli (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/composio-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

### Paso 1: instala e inicia sesión

Los comandos oficiales son:

```bash
curl -fsSL https://composio.dev/install | sh
```

Abre otra terminal y ejecuta:

```bash
composio login
```

### Paso 2: inspecciona antes de ejecutar

El ejemplo de Gmail de la guía comienza con:

```bash
composio search "resume mi correo de Gmail sin leer"
composio execute GMAIL_FETCH_EMAILS --get-schema
```

En una cuenta Gmail de prueba, prepara un mensaje sin leer de las últimas 24 horas. Completa la conexión de la aplicación y la lectura del ejemplo oficial:

```bash
composio link gmail
composio execute GMAIL_FETCH_EMAILS -d '{ query: "is:unread newer_than:1d", max_results: 10 }'
```

La conexión de Composio y la autorización de Gmail son pasos distintos. Comprueba que aparece el mensaje de prueba y que la cuenta conectada es la prevista. El resultado puede contener correo privado: no publiques la salida completa.

## Comprobación

La búsqueda debe devolver herramientas y el esquema debe coincidir con la operación elegida. Prueba primero una lectura y contrasta el resultado con la aplicación.

## Si algo falla

Revisa autenticación y backend si falta acceso. Si una operación termina por tiempo, verifica su resultado antes de repetirla; el tiempo de espera agotado no demuestra que no se ejecutó.