TimeAM CLI – FAQ
Allgemein
Was ist die TimeAM CLI?
Die TimeAM CLI ist ein Kommandozeilen-Tool für die Zeiterfassung. Du kannst direkt aus dem Terminal einstempeln, ausstempeln, Schichten prüfen und vieles mehr – ohne den Browser zu öffnen.
Wo bekomme ich meinen API-Token?
In der Web-App unter Einstellungen → API-Token. Der Token wird einmalig angezeigt. Bewahre ihn sicher auf.
Ist die CLI kostenlos?
Die CLI ist Teil von TimeAM und in allen Plänen enthalten.
Welche Betriebssysteme werden unterstützt?
- macOS (Intel + Apple Silicon)
- Linux (x64, ARM64)
- Windows (x64)
Voraussetzung: Node.js 18+.
Sicherheit
Wie wird mein Token gespeichert?
Der Token wird mit AES-256-GCM verschlüsselt auf der Festplatte gespeichert. Der Verschlüsselungsschlüssel wird aus einer maschinenspezifischen ID abgeleitet. Die Konfigurationsdatei hat die Berechtigung 600 (nur Besitzer kann lesen/schreiben).
Kann jemand meinen Token stehlen?
Der Token ist verschlüsselt gespeichert und nur auf deinem Rechner entschlüsselbar. Dennoch:
- Gib deinen Token nie weiter
- Verwende den Token nicht in Skripten als Klartext
- Rotiere den Token regelmäßig in den Web-App-Einstellungen
Werden Daten über HTTPS übertragen?
Ja, alle Verbindungen zur API nutzen ausschließlich HTTPS. HTTP-Verbindungen werden blockiert (mit Ausnahme von localhost für die Entwicklung).
Web-Terminal
Was ist das Web-Terminal?
Das Web-Terminal ist ein In-Browser-Terminal, das direkt in der TimeAM Web-App verfügbar ist. Es bietet dieselben Kernbefehle wie die CLI, ohne dass du etwas installieren musst.
Wie öffne ich das Web-Terminal?
Klicke auf das Terminal-Icon (>_) in der oberen Leiste der Web-App. Das Terminal öffnet sich als Overlay.
Funktioniert das Web-Terminal auf dem Handy?
Ja. Das Web-Terminal ist Mobile-First gestaltet und öffnet sich auf dem Handy im Vollbildmodus.
Welche Befehle gibt es im Web-Terminal?
Tippe help im Web-Terminal für eine Übersicht. Die wichtigsten:
clock in/clock out– Ein-/Ausstempelnclock status– Aktueller Statusshifts today– Heutige Schichtenwhoami– Benutzerinfoclear– Terminal leeren
Probleme
Der Befehl timeam wird nicht gefunden
Siehe Fehlerbehebung.
Die CLI zeigt „Nicht authentifiziert"
Führe timeam login aus und gib deinen Token ein. Siehe Fehlerbehebung.