CLI (línea de comandos)

La CLI tracker (el paquete @aquarela/tracker en npm) lleva tracker a la terminal. Es el camino más simple para agentes que ejecutan comandos, como Claude Code y Codex: ya saben usar una CLI, leen la ayuda solos y no cargan las tools del MCP en su contexto. Por debajo es la API REST, con las mismas reglas y permisos de la pantalla, en nombre de quien inició sesión.

Instalar e iniciar sesión

npm install -g @aquarela/tracker
tracker login

Necesita Node.js 20 o más nuevo (sin instalar: npx @aquarela/tracker). tracker login abre el navegador: la persona autoriza la CLI en una pantalla como la del MCP, eligiendo las empresas y si puede escribir. La sesión se guarda en ~/.config/tracker, legible solo por esa persona, y se renueva sola; tracker logout cierra la sesión y desconecta. Sin navegador (servidor, contenedor, CI), usa un token personal: TRACKER_TOKEN en el entorno, o tracker login --with-token con el token en la entrada estándar. tracker whoami muestra quién inició sesión, las empresas y el acceso. La persona encuentra estos comandos, listos para copiar, en https://tracker.aquarela.app/account/cli (Tu cuenta → Apps y API → CLI).

Comandos

• tracker issues list: la búsqueda de GET /issues, con los mismos filtros (-p proyecto, --open, --mine, -s estado, -q texto, --query consulta avanzada, --filter filtro guardado, --limit, --offset).
• tracker issues view <código>: la issue, con --comments para los comentarios y --fields para solo algunas partes.
• tracker issues create: crea una (-p, -t, -d o -D con un archivo, --type, --severity, --priority, -a, -l, --field, --external-id, --similar).
• tracker issues update <código>: edita solo lo que envíes (--assignee, --add-label, --remove-label, --sprint, --release, --fix-notes, --edit-version y otros).
• tracker issues status <código> <estado>: cambia el estado por la clave del flujo del proyecto (--reason al cerrar).
• tracker issues comment <código>: comenta (-b texto, -B un archivo o la entrada estándar, --reply-to, --attach).
• tracker issues attach <código> <archivos>: adjunta; por encima de 15 MB, por el envío directo de POST /uploads.
• tracker projects list y tracker projects view <prefijo>: los proyectos, con los estados, los tipos y los campos de cada uno.
• tracker similar "<texto>" (o --issue <código>): "¿Ya pasó antes?", por GET /search.
• tracker docs list, tracker docs search "<pregunta>" y tracker docs view <slug>: la base de conocimiento.
• tracker org list y tracker org use <slug>: las empresas de la sesión y la predeterminada.
• tracker api <ruta>: cualquier ruta de la API, con la sesión de la CLI, como gh api: -X el método, -f y -F (con tipo) arman el cuerpo JSON, --input envía un cuerpo listo.
• tracker llms: este manual, sin sesión.

tracker <comando> --help muestra las opciones y los ejemplos de cada comando.

Para agentes y scripts

• --json en cualquier comando imprime la respuesta de la API tal como llegó, con los campos documentados aquí. Los errores salen por la salida de error, en JSON con --json (error, message, status).
• Códigos de salida: 0 todo bien, 1 error de la API o de la red, 2 uso incorrecto, 4 sin sesión o sesión vencida.
• --org <slug> (o TRACKER_ORG) elige la empresa de la llamada, por el encabezado X-Tracker-Organization, cuando la sesión incluye más de una.
• En el límite de llamadas (429), la CLI espera el Retry-After y vuelve a intentar.
• Entorno: TRACKER_TOKEN, TRACKER_ORG, TRACKER_HOST (predeterminado https://tracker.aquarela.app) y TRACKER_LANG (pt, en o es; sin él, el idioma de la cuenta).

Ejemplo de instrucción para el AGENTS.md o el CLAUDE.md de un repositorio:

Las tareas de este repositorio están en tracker, proyecto MOB. Usa la CLI `tracker` con --json:
`tracker issues list -p MOB --open --json`, `tracker issues view` y `tracker issues comment`.
Antes de crear una tarea, ejecuta `tracker similar`.