HookTap CLI

Die HookTap CLI bringt HookTap direkt in dein Terminal.

Mit einem einfachen Command kannst du Push-Benachrichtigungen an dein iPhone senden – aus lokalen Skripten, CI-Jobs, Deployments, Cronjobs, Monitoring-Checks und Automationen.

Wenn etwas in deinem Terminal passiert, kann HookTap dich genau dann benachrichtigen, wenn es wichtig ist.

CLI installieren

macOS und Linux

Installiere HookTap mit dem Curl-Installer:

curl -fsSL https://hooktap.me/install.sh | sh

macOS (Homebrew)

brew install HookTap/tap/hooktap

Windows (Scoop)

scoop bucket add hooktap https://github.com/HookTap/scoop-bucket
scoop install hooktap

Mit deinem iPhone verbinden

Am einfachsten verbindest du die CLI direkt über die HookTap iPhone-App.

Öffne den CLI-Pairing-Screen in der App, erzeuge einen Einmal-Code und führe im Terminal aus:

hooktap setup --code 123456

Die CLI speichert dein Webhook-Profil und sendet einen Test-Event, damit du direkt prüfen kannst, ob alles funktioniert.

Alternativ kannst du die CLI manuell einrichten:

hooktap setup

oder:

hooktap config set hook_id DEINE_WEBHOOK_ID

Erste Benachrichtigung senden

Nach dem Setup sendest du einen Event mit:

hooktap send "Build fertig"

Mehr Kontext fügst du mit einem Body hinzu:

hooktap send "Deploy fertig" --body "Staging ist live"

Du kannst außerdem festlegen, wie HookTap den Event behandeln soll:

hooktap send "Nightly Report bereit" --type feed
hooktap send "Widget aktualisiert" --type widget

Standardmäßig nutzt die CLI push, also eine direkte iPhone-Push-Benachrichtigung.

Command-Output ans iPhone senden

Die CLI funktioniert hervorragend mit Unix-Pipes.

Zum Beispiel kannst du Deployment-Output als Notification-Text senden:

make deploy | hooktap send "Deploy fertig"

Oder einen Report:

cat report.txt | hooktap send "Nightly Report"

Das macht HookTap nützlich für lange laufende Commands, lokale Skripte und Entwicklungs-Workflows.

Benachrichtigt werden, wenn Commands fertig sind

Der watch-Command führt einen anderen Command aus und sendet eine Benachrichtigung, sobald dieser beendet ist.

hooktap watch -- npm run build

Mit eigenem Titel:

hooktap watch --title "Production Deploy" -- make deploy

Die Ausgabe des ausgeführten Commands läuft normal weiter. hooktap watch beendet sich außerdem mit demselben Exit Code wie der ausgeführte Command.

Dadurch kannst du es nutzen, ohne bestehende Skripte oder CI-Verhalten zu verändern.

Raw JSON senden

Wenn dein Webhook Field Mapping nutzt, kannst du vollständige JSON-Payloads direkt senden.

generate-payload.sh | hooktap send --raw

HookTap empfängt das JSON unverändert und wendet das Mapping an, das du in der App konfiguriert hast.

Das ist hilfreich beim Testen von Payloads aus GitHub, Stripe, Vercel, Zapier, Make, n8n oder eigenen internen Tools.

Profile nutzen

Wenn du mit mehreren Webhooks arbeitest, helfen Profile dabei, sie sauber zu trennen.

hooktap config set hook_id abc123 --profile ci
hooktap config set type feed --profile ci
hooktap config use ci
hooktap config list

Profile eignen sich gut für persönliche Alerts, CI-Benachrichtigungen, Production Deploys, Staging Deploys und Team-Workflows.

Terminal UI öffnen

Die CLI enthält auch eine interaktive Terminal UI:

hooktap

oder:

hooktap tui

In der Terminal UI kannst du Events schreiben, Profile prüfen, Snippets kopieren und einfache Diagnosen ausführen.

Service Health prüfen

Mit ping prüfst du, ob der HookTap-Service erreichbar ist:

hooktap ping

Das ist praktisch, wenn du dein Setup debuggen oder die Verbindung von einem Rechner aus testen möchtest.

Gebaut für Entwickler-Workflows

Die HookTap CLI verhält sich wie ein normales Kommandozeilen-Tool.

Sie unterstützt:

• stdin
• Profile
• Raw JSON
• maschinenlesbare Ausgabe
• Shell Completions
• sinnvolle Exit Codes
• ein einfaches Setup

Du kannst sie nutzen für:

• Lokale Builds
• Deployments
• CI-Jobs
• Cronjobs
• Monitoring-Checks
• Automationsskripte
• JSON-Payload-Tests
• Persönliche Entwickler-Benachrichtigungen

HookTap macht aus Webhooks iPhone-Benachrichtigungen. Die CLI bringt das überall dorthin, wo dein Terminal läuft.