CLI scrydon

La CLI de développement Scrydon authentifie votre machine auprès d'une installation Scrydon. Une fois connecté, les outils qui communiquent avec la plateforme peuvent utiliser le jeton stocké au lieu de vous demander vos identifiants.

Installation

Exécutez-la sans l'installer :

bunx @scrydon/cli login https://app.example.com

Ou installez-la pour que scrydon soit dans votre PATH :

bun add -g @scrydon/cli
# or: npm install -g @scrydon/cli
scrydon login https://app.example.com

Connexion

scrydon login utilise le flux d'autorisation d'appareil OAuth (RFC 8628) — le même principe que gh auth login. La CLI affiche une URL et un code ; vous approuvez la demande dans votre navigateur, et la CLI stocke le jeton obtenu.

$ scrydon login https://app.example.com
Logging in to https://app.example.com...

Open this URL in your browser to approve the login request:
  https://app.example.com/device?user_code=ABCD-1234

Or enter code ABCD-1234 at:
  https://app.example.com/device

Waiting for approval (expires in 300s)...

Login successful. Credentials saved to ~/.scrydon/credentials.json

Les jetons sont écrits dans ~/.scrydon/credentials.json avec le mode 0600, indexés par URL d'installation. Vous pouvez être connecté à plusieurs installations à la fois.

scrydon login https://app.example.com --auth-base /auth

Vérifier et effacer votre session

scrydon whoami                        # which installations are logged in
scrydon logout https://app.example.com  # forget one
scrydon logout                          # forget all of them

CI et environnements scriptés

Un pipeline ne doit pas exécuter la commande scrydon login simple ci-dessus — ce flux authentifie une personne via un navigateur, ce dont un pipeline ne dispose pas. Deux options, pour deux types d'appelants différents :

• Un pipeline qui s'authentifie avec sa propre identité machine (le cas courant) : scrydon login <url> --service-account <client-id> --service-account-secret <secret> [--ttl <duration>]. Cette commande échange un identifiant client et un secret durables — issus de Settings → Service accounts — contre un jeton bearer de courte durée, sans aucun navigateur, et le stocke de la même manière que le flux d'appareil. Voir AI Gateway → Pour les pipelines pour un exemple de CI complet.
• Un script exécuté sous l'identité propre d'une personne (par exemple un script de maintenance ponctuel qu'un développeur exécute localement avec ses propres accès, et non un pipeline planifié) : définissez plutôt SCRYDON_API_KEY avec un jeton d'accès personnel.

export SCRYDON_API_KEY="scy_..."

SCRYDON_API_KEY est prioritaire sur tous les identifiants stockés, y compris ceux enregistrés par --service-account. Comme elle désigne un jeton mais pas un hôte, elle ne peut pas indiquer aux outils à quelle installation s'adresser — fournissez l'URL explicitement partout où elle est requise. scrydon whoami vous avertit lorsque la variable est définie, pour qu'un problème de mauvais compte ne vous oblige pas à fouiller le fichier d'identifiants.

Création de packs et d'intégrations

La création de packs, d'intégrations, de workflows ou de process flows relève d'une CLI distincte, avec une empreinte de dépendances bien plus importante :

bunx @scrydon/sdk-authoring --help

Voir Création. Elle réutilise la même connexion et le même fichier d'identifiants : scrydon login couvre donc les deux.