Aperçu de la CLI

La CLI suya est l’interface principale de Subaya — pour les humains, les agents IA et la CI à la fois. Tout ce que vous pouvez faire à travers la plateforme commence ici ; la console web sur subaya-dev.com sert aux résultats, formes d’onde, rapports et revues. Consultez Concepts fondamentaux pour le modèle mental et le Démarrage rapide pour passer de l’installation à une simulation réussie.

Drapeaux globaux

Ces drapeaux fonctionnent sur chaque commande :

Drapeau	Description
`--host <url>`	Hôte API cible. Par défaut `https://subaya-dev.com`.
`--token <token>`	Utiliser un jeton d’authentification explicite pour cette invocation.
`--json`	Émettre une sortie JSON lisible par machine.
`--pretty`	Mettre en forme la sortie pour les humains.
`-q`, `--quiet`	Supprimer la sortie non essentielle.
`-v`, `--verbose`	Afficher des détails de diagnostic supplémentaires.

--json s’accorde bien avec les agents et la CI ; --pretty est la valeur par défaut conviviale pour un terminal.

Configuration de projet — `.subaya/config.toml`

La plupart des commandes à portée projet lisent leur --project par défaut depuis un fichier .subaya/config.toml local. Une fois qu’un projet est initialisé dans un répertoire (voir suya project), des commandes comme suya project show, suya sim run et suya repo status opèrent sur ce projet sans que vous ayez à passer --project à chaque fois. Passez --project <project-id> explicitement pour outrepasser.

Authentification

Deux modes se résolvent contre la même API — détails complets dans Authentification & clés API et la référence suya auth :

SUBAYA_API_KEY — une variable d’environnement pour les agents et la CI. Pas de navigateur.
suya auth login — flux OAuth dans le navigateur pour les développeurs humains.

export SUBAYA_API_KEY="sk_..."
suya auth whoami

Groupes de commandes

Groupe	Ce qu’il fait
`suya auth`	Se connecter, se déconnecter et inspecter votre identité.
`suya project`	Créer, lister et gérer les projets et les phases.
`suya sim`	Lancer des simulations cloud et inspecter les résultats.
`suya hw`	Exécutions de validation matérielle et gestion des agents (BitCrucible).
`suya rag`	Rechercher et lire la base de connaissances.
`suya plan`	Documents de planification, éléments de travail et diagrammes.
`suya repo`	Créer ou connecter un dépôt GitHub pour un projet.
`suya device`	Parcourir le catalogue de dispositifs et assigner un dispositif.
Session	`suya attach` / `suya detach` votre pod de session.

Autres groupes de commandes

Ces groupes complètent la surface :

suya arch — architecture et planification des broches embarquées (modules, pin-plans, configuration peripheral/clock, validate, generate, commit .ioc).
suya req — ajouter et lister les exigences d’un projet (suya req add, suya req list).
suya review — revues de code et de conception (create, show, list, comment, reply, resolve, approve, et plus).
suya diagram — créer et rendre des diagrammes Mermaid en SVG/PNG (create, update, show, list, export, render, delete).

Commandes de premier niveau

Commande	Description
`suya version`	Afficher les métadonnées de version.
`suya update [--check]`	Mettre à niveau vers la dernière version ; `--check` se contente de signaler la disponibilité.
`suya install [--skills] [--path <p>] [--force]`	Installer les intégrations Subaya (suya-cli + bundles de skills planner).
`suya completion <shell>`	Afficher l’autocomplétion shell pour le shell donné.