Hellotracks CLI
npm · @hellotracks/ht-cliht-cli es la interfaz de línea de comandos oficial de Hellotracks. Crea trabajos, optimiza rutas, sincroniza lugares, gestiona miembros y webhooks, rota claves API: desde tu shell, tu runner de CI o un agente de IA. La salida es estructurada y las mutaciones se previsualizan antes de ejecutarse.
ht auth loginht jobs sync --file work-orders.csv --upsert-by externalId --dry-runht routing optimize --account worker-uid --date today --solveht webhooks set --event job.updated --url https://ops.example.com/hookResumen del plan
Mutaciones pendientes
Para operadores e ingenieros
Inspecciona, crea, importa y enruta el trabajo desde scripts, terminales y runbooks. La CLI está pensada para operaciones repetibles: ese tipo de trabajo que nadie debería hacer a clics dos veces.
ht jobs sync --file work-orders.csv --upsert-by externalId --dry-runImporta desde hojas de cálculo, CRMs, ERPs o exportaciones de despacho. `--dry-run` previsualiza el plan; quítalo para aplicar. Usa `--continue-on-error` para ejecuciones resilientes.
ht routing optimize --account worker-uid --date today --solveConéctalo a cron a las 06:00. El optimizador resuelve el día; el despacho empieza la mañana con un plan listo en lugar de una acumulación de trabajo.
ht apikeys create --label nightly-sync --source automationLas claves etiquetadas y con origen aparecen en `ht apikeys list`. Revoca la anterior con `ht apikeys revoke <id> --yes`. CI mantiene los secretos fuera del historial de la shell mediante `HELLOTRACKS_API_KEY_FILE`.
Para agentes de IA
La mayoría de las APIs le dan al agente un cuchillo. ht-cli le da un skill: un manifiesto instalable, salida estructurada, mutaciones idempotentes y dry-runs como verbo por defecto. Los agentes razonan sobre lo que están a punto de hacer, y tú conservas las redes de seguridad.
ht skills installInstala el `SKILL.md` de Hellotracks tanto en Codex (`~/.codex/skills/hellotracks/`) como en Claude Code (`~/.claude/skills/hellotracks/`). Los agentes descubren toda la superficie de comandos sin necesidad de entrenarse en ella.
--output json | yaml | csv | ndjsonCada comando admite salida estable legible por máquina. `--fields a,b,c` proyecta, `--sort -date` ordena. Los agentes parsean: nunca hacen screen-scraping.
--dry-run · --profile prod · --confirm-profile prodLas mutaciones se previsualizan antes de ejecutarse. Los perfiles aíslan los entornos. `--confirm-profile` es una protección estricta contra el tenant equivocado. Los agentes previsualizan y luego confirman, no al revés.
Flujos de trabajo reales
Nada aspiracional. Estos son los patrones que los ingenieros de plataforma y los responsables de despacho montan el día que instalan la CLI.
Un `ht jobs sync --upsert-by externalId` programado extrae las órdenes de trabajo abiertas, crea o actualiza los trabajos correspondientes y los enruta al equipo adecuado, por externalId, de modo que las reejecuciones son idempotentes.
Una llamada de cron a las 06:00 a `ht routing optimize --account <uid> --date today --solve` le entrega al despacho un plan limpio. Sin carreras de enrutamiento a primera hora de la mañana.
`ht webhooks set --event job.updated --url …` conecta Hellotracks con facturación, informes, comunicación con clientes, Slack: configurado una vez, listado con `ht webhooks list`, auditado de forma limpia.
Un CI semanal ejecuta `ht apikeys create --label weekly --source github-actions`, cambia el secreto en el vault y luego `ht apikeys revoke <prior> --yes`. Las etiquetas y los orígenes mantienen contentos a los auditores.
RR. HH. sube workforce.yaml; los sistemas de activos suben customers.ndjson. `ht members sync --upsert-by username` y `ht places sync --upsert-by name` concilian: sin desviaciones, sin identidades huérfanas.
`ht --profile production --confirm-profile production jobs sync …` falla de forma evidente si el perfil activo es el equivocado. `ht profiles doctor` confirma que cada entorno está en buen estado.
Cobertura
ht-cli está construido sobre la API pública de Hellotracks. Las mismas primitivas que impulsan las integraciones personalizadas se convierten en comandos duraderos: personas, scripts y agentes comparten el mismo vocabulario.
list · get · create · update · archive · restore · delete · import · sync · export
list · get · create · update · delete · import · sync · export · columns · template
list · get · create · update · import · sync · export · columns · template
optimize · --solve · --account · --date
list · set · per-event filters
list · create · revoke · delete · labels · sources
list · create · use · doctor · --confirm-profile
auth login · logout · whoami · validate · skills install
Instalación
Instálalo una vez y usa la misma superficie de comandos desde tu portátil, runner de CI, worker de cron o runtime del agente. La autenticación es un único inicio de sesión: las credenciales van al keychain de tu sistema en macOS o se quedan en HELLOTRACKS_API_KEY_FILE en servidores.
curl -fsSL https://cli.hellotracks.org/install.sh | bashht auth loginht auth whoami && ht jobs list --date todayht skills install