Zum Inhalt

TimeAM CLI – Fehlerbehebung

Häufige Probleme

„timeam: command not found"

Die CLI ist nicht global installiert oder nicht im PATH.

Lösung:

# Erneut installieren
npm install -g @timeam/cli

# Prüfen, ob npm-Binaries im PATH sind
npm config get prefix
# Ausgabe z.B.: /usr/local
# → /usr/local/bin muss im PATH sein

„Nicht authentifiziert"

Du bist nicht angemeldet oder der Token ist abgelaufen.

Lösung:

timeam logout
timeam login

„Netzwerkfehler" / „Request timeout"

Die API ist nicht erreichbar.

Mögliche Ursachen:

  • Keine Internetverbindung
  • API-Server nicht verfügbar
  • Firewall blockiert HTTPS-Verbindungen

Lösung:

# API-URL prüfen
timeam config

# API-URL setzen (falls falsch)
timeam config set apiUrl https://api.timeam.de

„Permission denied" beim Lesen der Konfiguration

Die Konfigurationsdatei hat falsche Berechtigungen.

Lösung (macOS/Linux):

chmod 600 ~/.config/timeam/credentials.json
chmod 700 ~/.config/timeam/

Token wird nicht gespeichert

Die Verschlüsselung der Konfiguration kann auf manchen Systemen fehlschlagen.

Lösung:

# Konfigurationsordner manuell erstellen
mkdir -p ~/.config/timeam
chmod 700 ~/.config/timeam

# Erneut anmelden
timeam login

Web-Terminal reagiert nicht

Das Web-Terminal benötigt eine aktive Authentifizierung.

Lösung:

  1. Prüfe, ob du in der Web-App eingeloggt bist
  2. Lade die Seite neu (F5)
  3. Melde dich ab und wieder an

Debug-Modus

Für detaillierte Fehlerinformationen:

timeam --debug clock status

Weitere Hilfe

  • FAQ – Häufige Fragen
  • Befehlsreferenz – Alle Befehle
  • Helpdesk: Erstelle ein Ticket in der Web-App unter „Helpdesk"