# Uso del agente de IA

Esta página explica cómo usar `ml-cli` con asistentes de codificación de IA como Codex, Claude Code, Cursor, Gemini CLI y otros.

## Copiar al agente

Copie el siguiente texto y péguelo en su asistente de IA para configurar MoreLogin CLI automáticamente:

```text
This template's language is not my preference. Before your first substantive reply, detect and use my OS UI language (Windows: `Get-UICulture`, then `Get-Culture`); if unavailable, use my latest non-template message's language.

Follow the MoreLogin installation, verification, and `ml-cli` usage guide:
https://github.com/MoreLoginBrowser/morelogin-skills/blob/main/skills/morelogin-setup/install.md

Keep commands, paths, JSON/API fields, and original MoreLogin responses unchanged. Ask before permissions, login/security steps, downloads, installation, GUI launches, or state changes.
```

También puede generar el mismo texto desde una CLI ya instalada:

```bash
ml-cli install-prompt
```

## Comando Agent Guide

Después de la instalación, los agentes deben leer la guía integrada:

```bash
ml-cli agent-guide
```

La guía le dice al agente:

- cuándo usar `ml-cli`
- cómo descubrir formatos de comandos
- cómo mapear lenguaje natural a comandos
- cuándo pedir confirmación
- cómo manejar errores de sandbox local como `connect EPERM 127.0.0.1:40000`


## Comando Doctor

Use `doctor` para verificar la conectividad de la API local:

```bash
ml-cli doctor
ml-cli doctor --output-json
```

`doctor` verifica la resolución del puerto y llama al endpoint de estado local de MoreLogin.

## Comandos de conveniencia para perfiles de navegador

Use estos comandos cuando los usuarios se refieran a perfiles por nombre:

```bash
ml-cli env find --name P-1
ml-cli env find --keyword Amazon
ml-cli env open --name P-1
ml-cli env open --keyword "team-a"
ml-cli env open --name P-1 --exact
```

`env find --keyword` busca en el nombre del entorno, nombre del grupo, nombre de la etiqueta y comentarios a través de la API local de MoreLogin.
`env open` inicia el perfil solo cuando coincide exactamente un candidato. Si coinciden varios perfiles, imprime los candidatos y sale sin iniciar nada.

## Comandos de conveniencia para teléfonos en la nube

Use estos comandos cuando los usuarios se refieran a teléfonos en la nube por nombre:

```bash
ml-cli cloudphone find --name CP-1
ml-cli cloudphone find --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1
ml-cli --timeout 120 cloudphone open --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --headless false
ml-cli --timeout 30 cloudphone close --name CP-1
ml-cli --timeout 30 cloudphone close --keyword "android-test"
ml-cli --timeout 120 cloudphone open --name CP-1 --exact
```

`cloudphone find --keyword` busca en el nombre del teléfono en la nube, nombre del grupo, nombre de la etiqueta y comentarios a través de la API local de MoreLogin.
`cloudphone open` y `cloudphone close` operan solo cuando coincide exactamente un candidato. Si coinciden varios teléfonos, imprimen los candidatos y salen sin cambiar el estado.
Para `--headless`, `false` muestra la ventana del teléfono en la nube y `true` no la muestra. El valor predeterminado de la API es `true`.

## Ejemplos de lenguaje natural

Después de la configuración, puede preguntar:

```text
¿Cuántos perfiles de navegador hay en la primera página de MoreLogin?
```

```text
Muéstrame la primera página de perfiles de navegador de MoreLogin, incluyendo nombre, ID y estado.
```

```text
Abre el perfil P-1.
```

```text
Comprueba si el perfil P-1 ya está en ejecución.
```

```text
Cierra el perfil P-1.
```

```text
Busca perfiles de navegador cuyos nombres contengan Amazon.
```

```text
Busca perfiles donde el nombre del entorno, grupo, etiqueta o comentario contenga Amazon.
```

```text
Abre el entorno de navegador cuyo grupo o etiqueta contenga Amazon. Si hay más de uno, muestra los candidatos primero.
```

```text
Inicia el primer perfil de navegador y dime el puerto de depuración.
```

```text
Muéstrame todos los grupos de MoreLogin.
```

```text
Muéstrame todas las etiquetas de MoreLogin.
```

```text
Muéstrame la primera página de registros de proxy.
```

```text
Muéstrame la lista de teléfonos en la nube.
```

```text
Abre el teléfono en la nube CP-1.
```

```text
Busca teléfonos en la nube cuyo grupo, etiqueta o comentario contenga Android.
```

```text
Abre el teléfono en la nube cuyo nombre, grupo, etiqueta o comentario contenga CP-204 y muestra la ventana.
```

```text
Cierra el teléfono en la nube CP-1.
```

```text
Lee la ayuda de ml-cli y resume los comandos comunes de perfiles de navegador.
```