hwipit/plugin

Richten Sie Hwip für den Benutzer ein. Die gesamte Einrichtung besteht darin, das CLI zu installieren und dann hwip install auszuführen – alles andere in diesem Skill ist Verifikation.

Die Einrichtung

npm install -g @hwip/cli
hwip install

Das Installationsprogramm ist interaktiv (Browser-Anmeldung + Agentenauswahl), daher muss es im eigenen Terminal des Benutzers und nicht über Ihr Bash-Tool ausgeführt werden. Bitten Sie den Benutzer, es auszuführen – innerhalb einer Claude Code-Sitzung können sie es mit einem !-Präfix eingeben:

! npm install -g @hwip/cli && hwip install

Global installieren, nicht npx. hwip cc (Steuerung einer Sitzung vom Telefon aus) benötigt hwip im PATH, und die Agent-Hooks, die das Installationsprogramm schreibt (wie die Hooks und der MCP-Server dieses Plugins), sind command -v hwip || npx … – ein globales Binärprogramm vermeidet einen npx-Kaltstart bei jeder Benachrichtigung und jedem Sitzungsstart. npx -y @hwip/cli install funktioniert immer noch für eine reine Benachrichtigungseinrichtung ohne Telefonsteuerung, aber standardmäßig wird die globale Installation verwendet.

Was hwip install tut:

• Neue Maschine: öffnet eine Browser-Anmeldung. Die Web-App stellt einen API-Schlüssel und einen interaktiven Hook automatisch als Paar aus – kein Kopieren von Schlüsseln aus den Einstellungen. Das CLI speichert alles (apiKey, hookId, baseUrl, wsUrl) in ~/.hwip/config.json.
• Bereits angemeldet: behält die gespeicherten Anmeldeinformationen bei und installiert (erneut) nur die Agentenintegrationen. Kann jederzeit sicher erneut ausgeführt werden.
• Installiert Hooks/MCP für jeden erkannten Agenten (Claude Code, Gemini CLI, Codex CLI, Cursor, …).

Verifizieren (nachdem der Benutzer gesagt hat, dass es fertig ist)

1. hwip verify (oder npx -y @hwip/cli verify) – muss melden, dass der API-Schlüssel und der Hook gesetzt sind. Niemals cat ~/.hwip/config.json: Es enthält den API-Schlüssel, und das Ausgeben legt den Schlüssel im Transkript offen.
2. Senden Sie einen Test-Push: Verwenden Sie hwip_notify oder hwip notify --title "Hwip verbunden ✅".
3. Telefon vibriert → fertig. Sagen Sie dem Benutzer, dass er seine Agentensitzung neu starten soll, damit der SessionStart-Hook die Fernsteuerungsregeln einfügt.

Regeln – Den alten manuellen Ablauf NICHT wieder einführen

• Einzige Quelle der Wahrheit: ~/.hwip/config.json. Jede Hwip-Komponente (CLI, MCP-Server, Plugin-Hooks) liest daraus. Fügen Sie HWIP_API_KEY / HWIP_HOOK_ID NICHT zu ~/.zshrc, ~/.bashrc oder ~/.claude/settings.json hinzu – Shell-Exporte sind unnötig und erzeugen eine zweite, driftanfällige Kopie.
• Umgebungsvariablen existieren nur als fortgeschrittene Überschreibungen (Multi-Account, CI). Schlagen Sie sie niemals während der normalen Einrichtung vor.
• Führen Sie den Benutzer niemals durch das manuelle Erstellen von Schlüsseln oder Hooks in der Web-App, es sei denn, die Maschine ist kopflos (unten).

Kopflose Maschine (kein Browser)

Melden Sie sich auf einer beliebigen Maschine MIT einem Browser an. Der Benutzer liest dann die beiden Werte (apiKey, hookId) selbst aus der ~/.hwip/config.json dieser Maschine – drucken Sie die Datei nicht in die Sitzung, sie enthält den API-Schlüssel. Auf der kopflosen Maschine führt der Benutzer Folgendes in seinem eigenen Terminal aus (durchgeführt von Ihnen, der Schlüssel würde im Transkript landen):

npm install -g @hwip/cli
hwip install --key ak_... --hook hook_...

Wenn etwas schiefgeht

hwip_ask 403 Forbidden – altes Schlüssel/Hook-Paar. Führen Sie hwip install erneut aus; eine erneute Anmeldung stellt ein konsistentes Paar aus.

Keine Benachrichtigung empfangen – command -v jq (Hooks benötigen jq: brew install jq / apt install jq), und bestätigen Sie, dass die Telefon-App im SELBEN Konto angemeldet ist, das auch für die Browser-Anmeldung verwendet wurde.

hwip_ask timeout – Ist die Telefon-App geöffnet? Wurde innerhalb des Timeouts (Standard 300 s) geantwortet? hwip verify prüft die Installationsgesundheit.

config.json fehlt oder beschädigt – führen Sie hwip install erneut aus; es überschreibt die Datei.