Hellotracks CLI

npm · @hellotracks/ht-cli

Hellotracks, direkt vom Terminal.

ht-cli ist die offizielle Hellotracks-Kommandozeile. Erstelle Aufträge, optimiere Routen, synchronisiere Orte, verwalte Mitglieder und Webhooks, rotiere API-Keys — aus deiner Shell, deinem CI-Runner oder einem KI-Coding-Agenten. Die Ausgabe ist strukturiert, Mutationen werden vor der Ausführung als Vorschau gezeigt.

ht-cli installieren

Vertrieb kontaktieren

ht-cli

$ht auth login

$ht jobs sync --file work-orders.csv --upsert-by externalId --dry-run

$ht routing optimize --account worker-uid --date today --solve

$ht webhooks set --event job.updated --url https://ops.example.com/hook

ht jobs syncdry-run

Plan-Übersicht

+142 created

~38 updated

!2 with warnings

Ausstehende Mutationen

+Job · externalId=WO-2891

~Job · externalId=WO-2718 (address, priority)

!Job · externalId=WO-2719 (missing assigneeUsername)

Ohne --dry-run erneut ausführen, um anzuwenden

ht-Ressourcenauthjobsplacesmembersroutingwebhooksapikeysprofilesskills

Für Operatoren & Engineers

Mach ein Skript daraus, keinen Klick.

Prüfe, erstelle, importiere und route Arbeit aus Skripten, Terminals und Runbooks. Die CLI ist für wiederholbare Abläufe gemacht — die Art von Arbeit, die niemand zweimal anklicken sollte.

Massen-Sync ohne erneutes Eintippen

ht jobs sync --file work-orders.csv --upsert-by externalId --dry-run

Importiere aus Tabellen, CRMs, ERPs oder Dispatch-Exporten. `--dry-run` zeigt den Plan als Vorschau; weglassen, um anzuwenden. Nutze `--continue-on-error` für robuste Durchläufe.

Routen vor dem Dispatch optimieren

ht routing optimize --account worker-uid --date today --solve

Häng es um 06:00 an einen Cron. Der Optimierer löst den Tag; der Dispatch startet den Morgen mit einem fertigen Plan statt mit einem Rückstau.

Anmeldedaten mit Audit-Trail rotieren

ht apikeys create --label nightly-sync --source automation

Beschriftete Keys mit Quelle landen in `ht apikeys list`. Widerrufe den vorherigen mit `ht apikeys revoke <id> --yes`. CI hält Secrets über `HELLOTRACKS_API_KEY_FILE` aus dem Shell-Verlauf heraus.

Für KI-Coding-Agenten

Ein Agent-Skill, keine umhüllte API.

Die meisten APIs geben Agenten ein Messer in die Hand. ht-cli gibt ihnen einen Skill: ein installierbares Manifest, strukturierte Ausgabe, idempotente Mutationen und Dry-Runs als Standardverb. Agenten überlegen, was sie gleich tun — und du behältst die Sicherheitsnetze.

Den Skill installierenht skills install

Legt das Hellotracks-`SKILL.md` sowohl in Codex (`~/.codex/skills/hellotracks/`) als auch in Claude Code (`~/.claude/skills/hellotracks/`) ab. Agenten entdecken die gesamte Befehlsoberfläche, ohne darauf trainiert zu sein.

Strukturierte, parsebare Ausgabe--output json | yaml | csv | ndjson

Jeder Befehl unterstützt stabile maschinenlesbare Ausgabe. `--fields a,b,c` projiziert, `--sort -date` sortiert. Agenten parsen — sie betreiben nie Screen-Scraping.

Sicher als Standard--dry-run · --profile prod · --confirm-profile prod

Mutationen werden vor der Ausführung als Vorschau gezeigt. Profile isolieren Umgebungen. `--confirm-profile` ist ein harter Schutz gegen den falschen Mandanten. Agenten zeigen erst die Vorschau und committen dann — nicht umgekehrt.

Echte Workflows

Was Teams in der ersten Woche mit ht-cli umsetzen.

Nichts Wunschdenken. Das sind die Muster, die Plattform-Engineers und Dispatch-Leiter am Tag der CLI-Installation einrichten.

CRM / Arbeitsaufträge speisen den Dispatch nächtlich

Ein geplantes `ht jobs sync --upsert-by externalId` zieht offene Arbeitsaufträge, erstellt oder aktualisiert die passenden Aufträge und routet sie ans richtige Team — anhand der externalId, sodass erneute Läufe idempotent sind.

Routen sind vor Sonnenaufgang gelöst

Ein Cron-Aufruf um 06:00 an `ht routing optimize --account <uid> --date today --solve` übergibt dem Dispatch einen sauberen Plan. Kein Routing-Chaos zum Tagesbeginn.

Webhooks verteilen jedes Auftragsereignis

`ht webhooks set --event job.updated --url …` verbindet Hellotracks mit Abrechnung, Reporting, Kundenkommunikation, Slack — einmal konfiguriert, mit `ht webhooks list` aufgelistet, sauber auditiert.

API-Keys rotieren nach Zeitplan

Ein wöchentlicher CI-Lauf führt `ht apikeys create --label weekly --source github-actions` aus, tauscht das Secret im Vault und dann `ht apikeys revoke <prior> --yes`. Labels und Quellen freuen die Auditoren.

Mitglieder & Orte bleiben im Gleichschritt

HR schiebt workforce.yaml; Asset-Systeme schieben customers.ndjson. `ht members sync --upsert-by username` und `ht places sync --upsert-by name` gleichen ab — keine Drift, keine verwaisten Identitäten.

Profil-Schutz hält die Produktion sicher

`ht --profile production --confirm-profile production jobs sync …` schlägt laut fehl, wenn das falsche Profil aktiv ist. `ht profiles doctor` bestätigt, dass jede Umgebung gesund ist.

Abdeckung

Jede operative Oberfläche, hinter einer einzigen Binärdatei.

ht-cli baut auf der öffentlichen Hellotracks-API auf. Dieselben Primitive, die individuelle Integrationen antreiben, werden zu beständigen Befehlen — Menschen, Skripte und Agenten teilen dasselbe Vokabular.

Aufträge

list · get · create · update · archive · restore · delete · import · sync · export

Mitglieder

list · get · create · update · delete · import · sync · export · columns · template

Orte

list · get · create · update · import · sync · export · columns · template

Routenplanung

optimize · --solve · --account · --date

Webhooks

list · set · per-event filters

API-Keys

list · create · revoke · delete · labels · sources

Profile

list · create · use · doctor · --confirm-profile

Auth & Skills

auth login · logout · whoami · validate · skills install

Installation

Ein Befehl. Jede Umgebung.

Einmal installieren, dann dieselbe Befehlsoberfläche vom Laptop, CI-Runner, Cron-Worker oder der Agent-Laufzeit nutzen. Die Authentifizierung ist ein einziger Login — Anmeldedaten landen auf macOS im System-Keychain oder bleiben auf Servern in HELLOTRACKS_API_KEY_FILE.