Authentifizierung

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 login erneut ausführen.
• "No access to customer" — ay whoami prüfen, ggf. ay switch list und korrekten Context wählen.

Nächster Schritt

First-Run-Tutorial — die ersten fünf produktiven Befehle.