Usarla con un agente
La CLI está pensada para que un agente de IA la use tanto como una persona: puede leer un problema, buscar sus registros, arreglarlo y marcarlo como resuelto.
collector issues list --env production --json
collector issues show 2C7ZffP787kc --markdown > issue.md
collector logs --request F3xAbCdEfGh --markdown # la solicitud de la que vino
claude "Arregla el error de issue.md. Cuando el arreglo esté integrado, ejecuta: collector issues resolve 2C7ZffP787kc"
Dale una credencial a su medida
No le des tu sesión: crea una credencial de acceso para el agente, de solo lectura si solo tiene que mirar, o limitada a una organización, y dásela como COLLECTOR_TOKEN. Puedes revocarla cuando termine sin tocar tu propia sesión.
Lo que el agente tiene que saber
--markdownda el texto que Collector escribe para una IA: enissues show, el error, la pila de llamadas con el código alrededor de las líneas de tu aplicación, la solicitud, lo que pasó antes y las etiquetas; enlogs, una línea por registro, de arriba abajo como una historia.--json, en cualquier comando, imprime el JSON de Collector tal cual. Con--json, los errores salen en stderr como{"error": {"code", "message"}}.- Los resultados van a stdout; las pistas, el progreso y las advertencias, a stderr.
- Las listas muestran una página (
--limithasta 100, después--cursor), o todas con--all. - Los códigos de salida distinguen un rechazo (
1), un mal uso (2) y un problema de credencial (3). - Los mensajes de Collector y el Markdown siguen tu idioma en Collector;
--lang eno--lang es(oCOLLECTOR_LANG) piden uno. El texto propio de la CLI está en inglés. collector api <ruta>hace un pedido directo a la API, para lo que no tiene comando propio.collector open issue <id>imprime (y en una terminal abre) la página del problema en la aplicación web, para dejarle el enlace a una persona.
La guía para agentes
app.clt.chrom.ar/agents.md es una guía en Markdown para que un agente de programación, como Claude Code, ponga Collector en marcha en tu proyecto: instala la CLI, inicia sesión con collector login, elige o crea el proyecto (collector use <organización>/<proyecto>, collector dsn) y, según el lenguaje (Elixir, Node, JavaScript en el navegador u otro), instala el SDK y configura los errores, los registros, la velocidad y los mapas de código fuente. Termina comprobando que funciona, con collector test y collector issues list.
Es pública y no lleva secretos: el DSN lo saca collector dsn. Está en español y en inglés: ?lang=es o ?lang=en, y si no, el idioma de tu navegador.
Desde la aplicación
La tarjeta Usa Collector desde tu terminal, en la lista de proyectos, tiene Copiar instrucciones: copia esa misma guía, en tu idioma, para pegársela al agente.
La página de cada problema tiene Copiar como Markdown, el mismo texto que issues show --markdown. Y la Puesta en marcha tiene Copiar instrucciones, para que un agente configure el SDK en tu proyecto.