Command linev0.2

CLI Catalyst

Pilotez Catalyst depuis votre terminal : connectez-vous d'un clic navigateur, vérifiez qu'un build va passer, puis lancez un build apk ou build ipa (signé ou non) — le calcul tourne sur nos serveurs.

La CLI expose la même API publique que l'application web. Un seul binaire catalyst, publié sur deux registres avec un comportement identique — choisissez celui de votre écosystème.

Installation

Via npm (couvre aussi pnpm / yarn / bun — même registre) :

npm install -g catalyst-cli
# ou :  pnpm add -g catalyst-cli  ·  yarn global add catalyst-cli

Via pip (Python ≥ 3.8) :

pip install catalyst-cli

Vérifiez l'installation :

catalyst --version
catalyst --help

Connexion : login

catalyst login ouvre votre navigateur sur la page de connexion. Si vous n'êtes pas connecté, le site vous y invite ; sinon il vous demande simplement d'autoriser la CLI. Un jeton personnel (PAT) est créé, renvoyé à la CLI et stocké localement — vous n'avez rien à copier-coller.

catalyst login

Connexion sans navigateur (SSH / headless)

Sur une machine distante sans navigateur, deux options :

# 1. Coller un jeton généré sur un autre appareil :
catalyst login --no-browser

# 2. Fournir directement un PAT (scripts, CI/CD) :
catalyst login --token cat_xxxxxxxx_yyyyyyyyyyyyyyyy

Qui suis-je : whoami

Affiche l'utilisateur connecté, l'API utilisée et d'où vient le jeton (session, variable d'environnement ou option).

catalyst whoami
# → Logged in as you@example.com
#     api:   https://dev.bcat.website/catalyst/api
#     token: cat_ab12cd34…  (from ~/.catalyst/config.json)

Déconnexion : logout

Révoque le jeton côté serveur (il devient inutilisable) puis efface la session locale. Relancez catalyst login pour vous reconnecter ou changer de compte.

catalyst logout
# --keep-token : oublier seulement en local, sans révoquer côté serveur

Session, priorité & configuration

Pour chaque commande, l'API et le jeton sont résolus dans cet ordre (le premier trouvé gagne) :

Vérification préflight : check

Avant d'uploader et de builder, catalyst check vous dit en moins de 2 minutes si le build va passer ou être bloqué : contrôles locaux (projet vide, package.json invalide, lockfile manquant, fichiers trop lourds) puis contrôles serveur (framework détecté, cible compatible, quota / plan, durée estimée) — les mêmes règles que le vrai déclenchement.

catalyst check ./my-app --target android
#   [ ok ] files: 39 files, 1 MB after filtering
#   [ ok ] lockfile: package-lock.json found — deterministic install
#   [ ok ] server:target: expo → android supported
#   [ ok ] eta: similar expo/android builds take ~7m30s
#
#   SHOULD BUILD — no blocker found (3s).

Construire : upload, build, pull, run

Tout-en-un : run

Le plus simple : upload → build → pull en une commande, avec attente jusqu'à l'artefact téléchargé.

catalyst run ./my-app --target android --out app.apk
# zippe le dossier, crée le projet, lance le build APK,
# suit la progression et télécharge l'artefact dans app.apk

Étape par étape

# 1. Envoyer le code (crée un projet, ou --project-id pour rafraîchir)
catalyst upload ./my-app --name my-app          # → project_id=42

# 2. Lancer un build pour ce projet
catalyst build 42 --target ios --signing-mode unsigned   # → build_id=99

# 3. Suivre le build et récupérer l'artefact
catalyst pull 99 --out my-app.ipa

Cibles & signature — on choisit tout

Chaque commande de build accepte --target (web, iOS/.ipa, Android/.apk) et --signing-mode (signé / non signé). Le framework a une cible par défaut, mais vous pouvez toujours forcer l'autre (ex. un projet Expo par défaut en IPA, mais vous voulez un APK) :

catalyst build 42 --target android --signing-mode signed   # APK signé
catalyst build 42 --target ios     --signing-mode unsigned # IPA non signé
catalyst build 42 --target web                             # build web

Où tourne le build : --mode

Référence des commandes

Utilisation en CI/CD

En pipeline, pas de navigateur : fournissez le jeton via une variable d'environnement (créée dans Settings → API keys) et enchaînez check + run de façon non interactive.

export CATALYST_TOKEN="cat_xxxxxxxx_yyyyyyyyyyyyyyyy"

# Garde-fou : échoue le job si le build serait bloqué
catalyst check ./app --target android || exit 1

# Build + récupération de l'APK signé
catalyst run ./app --target android --signing-mode signed --out app.apk