Hilfe und FAQ
Keine Antwort gefunden? Schreib an meterkat@fabian-duerkop.de. Bitte schick nie Kopplungslinks, QR-Codes oder Tokens.
Einrichtung
Wie richte ich Meterkat ein?
- Claude Code und/oder die Codex-CLI müssen auf deinem Windows- oder Linux-Computer installiert und angemeldet sein. Einmal
claudeodercodexim Terminal starten genügt zur Kontrolle. - Lade den Begleiter für dein System im Download-Bereich herunter.
- Windows: PowerShell im Download-Ordner öffnen und
.\meterkat-companion-…-windows-x64.exe setupausführen.
Linux:tar -xzf meterkat-companion-…-linux-x64.tar.gz, dann./meterkat setup. - Setup prüft deine KI-Tools, installiert sich nur für deinen Benutzer (ohne Administratorrechte), fragt, ob er mit dem Computer starten soll, und zeigt zum Schluss einen QR-Code.
- Installiere Meterkat aus Google Play und scanne den QR-Code.
Windows meldet „Der Computer wurde durch Windows geschützt“
Der Begleiter ist noch nicht codesigniert, deshalb kennt SmartScreen ihn nicht. Wähle Weitere Informationen → Trotzdem ausführen. Wer die Datei vorher prüfen will, vergleicht Get-FileHash <Datei> mit der Datei SHA256SUMS der Version.
Muss der Begleiter ständig laufen?
Nur solange du aktuelle Werte willst. Hast du beim Setup dem Autostart zugestimmt, startet er bei der Anmeldung. Ändern mit meterkat autostart install oder meterkat autostart remove. Ist der Computer aus, zeigt das Handy den letzten Stand und markiert ihn als veraltet.
Welche KI-Tools und Abos werden unterstützt?
Claude Code (Claude-Abos) und die Codex-CLI (ChatGPT-Abos). Beide melden ein 5-Stunden- und ein Wochenlimit. Konten, die pro API-Aufruf bezahlen, haben solche Limits nicht; Meterkat zeigt sie als nicht verfügbar. Antigravity ist geplant.
Koppeln
Wie kopple ich ein weiteres Handy oder bekomme einen neuen QR-Code?
Auf dem Computer meterkat pair ausführen. Jeder Code gilt einmal und läuft nach 5 Minuten ab; ein neuer Code ersetzt den vorherigen. Bis zu 10 Handys lassen sich mit einem Computer koppeln.
Die App meldet, der Code sei abgelaufen oder schon benutzt
Führe meterkat pair erneut aus und scanne den neuen Code. Nach fünf Fehlversuchen wird ein Code aus Sicherheitsgründen gesperrt.
Warum kann ich den Code nicht abtippen?
QR-Code bzw. Link enthalten auch den Schlüssel für deine Daten. Ein kurzer Code könnte ihn nicht transportieren, deshalb funktioniert das Koppeln nur per QR-Code oder Link. Kannst du nicht scannen, bietet die Kopplungsseite des Begleiters einen Link, den du auf dem Handy öffnen kannst.
Die App verlangt, neu zu koppeln
Das passiert, wenn das Handy getrennt, der Begleiter gelöscht oder neu registriert oder sein Schlüssel erneuert wurde (meterkat rotate-key). meterkat pair ausführen und den neuen Code scannen.
Werte und Aktualisierung
Das Widget zeigt alte Werte oder „Aktualisiert“
Android aktualisiert Widgets etwa alle 15 Minuten und wartet zum Akkusparen manchmal länger. Öffne die App und tippe auf Nutzung aktualisieren. Werte, die älter als 5 Minuten sind, werden als veraltet markiert. Prüfe, ob der Begleiter läuft (meterkat inspect) und der Computer online ist. „Aktualisiert“ nach einem Rücksetzzeitpunkt heißt: Der neue Wert ist noch nicht gemeldet.
Ein Anbieter zeigt „Anmeldung nötig“ oder „nicht verfügbar“
Öffne das Tool (claude oder codex) auf dem Computer und melde dich neu an. Sehr alte Claude-Code-Versionen bieten den Nutzungsbericht nicht; bitte aktualisieren.
Warum weichen die Werte von der Website ab?
Meterkat zeigt genau, was das offizielle Tool zum Zeitpunkt der letzten Messung meldet. Die Website des Anbieters rundet eventuell anders oder aktualisiert zu einem anderen Zeitpunkt.
Daten löschen
Ein Handy entfernen
In der App Dieses Handy trennen wählen. Das entfernt den Zugang des Handys auf dem Relay und löscht die lokalen Daten. Vom Computer aus: meterkat devices listet die Handys, meterkat revoke <Geräte-ID> entfernt eines, meterkat revoke alle.
Alles auf dem Relay löschen
Auf dem Computer meterkat delete ausführen. Das löscht sofort deine Quelle, alle gekoppelten Handys und die gespeicherte verschlüsselte Aktualisierung auf dem Relay und entfernt den lokalen Schlüssel und die Zugangsdaten. Quellen ohne Upload seit 90 Tagen werden automatisch gelöscht, eine gespeicherte Aktualisierung verschwindet nach 72 Stunden ohne neue.
Kann ich gelöschte Daten zurückholen?
Nein. Es gibt kein Konto und keine Kopie deines Schlüssels; Löschen ist endgültig. Mit meterkat setup fängst du neu an.
Deinstallieren
Begleiter deinstallieren
meterkat delete(löscht die Relay-Daten, siehe oben).meterkat autostart remove- Programm löschen: Windows
%LOCALAPPDATA%\Programs\Meterkat\, Linux~/.local/bin/meterkat. - Den Statusordner löschen, falls noch vorhanden: Windows
%LOCALAPPDATA%\meterkat, Linux~/.local/state/meterkat.
App deinstallieren
Erst trennen (siehe oben), dann Meterkat wie jede App deinstallieren. Das löscht alles auf dem Handy. Ohne vorheriges Trennen bleibt der Zugangseintrag des Handys auf dem Relay, bis die Quelle gelöscht wird.
Datenschutz und Sicherheit
Kann der Relay-Betreiber meine Nutzung sehen?
Nein. Aktualisierungen werden auf deinem Computer verschlüsselt (AES-256-GCM), mit einem Schlüssel, den das Relay nie erhält. Das Relay sieht nur technische Daten wie Upload-Zeiten und Größen. Details in der Datenschutzerklärung.
Sieht Meterkat mein Claude- oder ChatGPT-Passwort?
Nein. Der Begleiter fragt die bereits angemeldeten Tools nur nach ihrem Nutzungsbericht. Anmeldedaten bleiben bei diesen Tools.
Ich habe ein gekoppeltes Handy verloren
Mit meterkat revoke allen Handys den Relay-Zugang entziehen, dann meterkat rotate-key, damit der Schlüssel des verlorenen Handys für neue Aktualisierungen nicht mehr passt, und die übrigen Handys neu koppeln.
Kann ich ein eigenes Relay nutzen?
Wer ein kompatibles Relay betreibt, kann dessen Adresse in den erweiterten Kopplungsoptionen der App eintragen und meterkat setup mit --relay <Adresse> aufrufen. Für die meisten ist das gehostete Relay die richtige Wahl.