lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema intermedio claude-codecodexclicomposio

Composio CLI: busca y ejecuta herramientas de aplicaciones conectadas

Conecta cuentas y consulta esquemas de herramientas desde la terminal para que tu agente trabaje con aplicaciones autorizadas.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.


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:

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

Abre otra terminal y ejecuta:

composio login

Paso 2: inspecciona antes de ejecutar

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

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:

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ó.

ver en .md ¿Prefieres el recurso entero?

Qué es

Composio CLI es la interfaz de terminal de Composio para agentes y personas. Ayuda a localizar herramientas, conectar cuentas, consultar sus argumentos y ejecutar operaciones sobre aplicaciones.

Para qué te sirve

  • Cuando quieres probar una herramienta de una aplicación sin escribir una integración completa.
  • Cuando tu agente necesita conocer el esquema antes de invocar una operación.
  • Cuando debes depurar autenticación o resultados de un conector desde la terminal.

Cómo funciona

La CLI utiliza la cuenta y backend registrados al iniciar sesión. Sus comandos de búsqueda, esquema y ejecución evitan adivinar nombres o parámetros de herramientas. Los plugins nativos exponen esas capacidades a clientes como Claude Code y Codex.

La herramienta vive en ts/packages/cli dentro del monorepo de Composio. Esta ficha apunta a esa carpeta para distinguirla de los SDK y otros componentes independientes del mismo repositorio.

Antes de empezar

Necesitas una cuenta y autorización sobre las aplicaciones que conectes. El instalador prepara el binario, PATH y, cuando detecta clientes compatibles, plugins; el inicio de sesión es un paso aparte. Revisa qué archivos propone cambiar el asistente.

Límites y alternativas

La documentación desaconseja basar una integración de producción en el contrato de la CLI, que cambia con frecuencia; para eso remite a SDK y API. Una ejecución que agota el tiempo puede haberse completado: comprueba la aplicación antes de repetir una escritura.

Recursos