Die meisten CLI-Befehle erfordern eine aktive Session. Die CLI nutzt auth.ayoune.app mit OAuth2-PKCE-Flow im Browser.
Anmelden
ay login
Der Befehl öffnet automatisch den Default-Browser auf https://auth.ayoune.app/?continue=.... Nach erfolgreicher Anmeldung wird das JWT lokal in ~/.aYOUne/storage/ abgelegt und automatisch alle 55 Minuten erneuert.
Aktuellen User anzeigen
ay whoami
Zeigt: User-ID, Email, aktiver Customer-Context, Rechte-Scope.
Customer-Context wechseln
Bei Multi-Tenant-Zugehörigkeit:
ay switch # interaktiver Picker
ay switch customer <slug> # direkt
ay switch back # zum vorherigen Context zurück
ay switch current # aktuellen Context anzeigen
ay switch list # alle verfügbaren Tenants
Abmelden
ay logout # Token löschen
Token-Storage inspizieren
ay storage set # Einzelnen Wert setzen
ay storage clear # Kompletten Storage leeren (forced logout)
Troubleshooting
- "Login Browser öffnet sich nicht" — Manuell zu
https://auth.ayoune.app/?continue=http://localhost:{port}navigieren (Port wird im Terminal ausgegeben). - "Session expired" — CLI refreshed JWT alle 55min. Wenn das Gerät länger offline war,
ay loginerneut ausführen. - "No access to customer" —
ay whoamiprüfen, ggf.ay switch listund korrekten Context wählen.
Nächster Schritt
First-Run-Tutorial — die ersten fünf produktiven Befehle.