Plus de commandes de la CLI

Au-delà d’init, la CLI couvre quatre missions : se connecter et choisir un espace de travail, vérifier ce qui est réellement en ligne, écrire votre intégration à votre place, et lire la configuration de votre espace depuis un terminal ou un job de CI.

Connexion et déconnexion

Connectez-vous avec votre navigateur : la CLI ouvre le tableau de bord, vous approuvez l'appareil, et une session liée à votre compte est enregistrée dans ~/.syncanix/credentials (lisible par vous seul) — la CLI agit ensuite avec votre rôle, dans vos espaces de travail. Utilisez --key pour une clé machine d'espace de travail (CI ; approbation administrateur), vérifiez votre identité avec syncanix whoami, et déconnectez-vous avec syncanix logout — la session est aussi révoquée côté serveur.

npx syncanix login
npx syncanix logout

Vérifiez qui vous êtes et où vous écrivez

Une session agit en votre nom : la même commande peut donc écrire dans un espace de travail différent selon celui qui est actif. syncanix whoami répond aux deux questions à la fois — votre identité, l’espace de travail actif et votre rôle, la date d’expiration de la session, et tous les espaces où vous pouvez agir. La réponse vient du serveur en direct, ce qui en fait aussi une vérification que votre session fonctionne toujours. syncanix workspace list affiche la même liste seule, et syncanix workspace use <slug> change l’espace dans lequel la prochaine commande écrira. Lancez whoami avant tout envoi.

npx syncanix whoami
npx syncanix workspace list
npx syncanix workspace use acme

Importer un schéma

Vous avez déjà un schéma OpenAPI ou GraphQL ? Construisez-en un catalogue directement, sans analyse de code. Passez --offline pour ne pas téléverser, ou --env pour cibler un environnement.

npx syncanix import --openapi ./openapi.json
npx syncanix import --graphql ./schema.graphql

Ma copie est-elle synchronisée ?

Compare ce qu’un scan neuf de cette copie trouve avec ce que votre espace de travail sert actuellement, et affiche la différence. C’est la commande à dégainer quand l’assistant fait quelque chose d’inattendu : elle répond à « la production tourne-t-elle ce que je crois ? » sans rien ouvrir.

npx syncanix status

Détectez un changement avant vos clients

Compare votre arbre de travail avec le catalogue que vous avez commité et sort en erreur s’ils ont divergé. Placez-le dans votre pipeline d’intégration continue : un changement sur ce dont dépend l’assistant fera échouer le build plutôt que d’apparaître dans une conversation.

npx syncanix drift

Le widget est-il vraiment sur la page ?

Charge une URL et indique si l’intégration Syncanix y est active. Plus rapide que d’ouvrir un navigateur, et utile dans un contrôle de déploiement — la raison la plus fréquente d’un chat absent est un build qui a perdu la balise script.

npx syncanix embed check https://app.acme.com

Écrivez-moi les fichiers d’intégration

Écrit un petit ensemble de fichiers Syncanix dans votre projet — l’intégration, la configuration, et ce dont votre stack a besoin. Il ne crée que des fichiers absents : l’exécuter deux fois est sans risque et il ne peut jamais écraser quelque chose que vous avez modifié.

npx syncanix generate

Intégrer le widget dans un frontend

Une version guidée du même travail pour un frontend existant, en quatre étapes exécutées une à une : il scanne votre app, planifie le changement, vous montre le plan à approuver, et ne l’applique qu’ensuite.

npx syncanix integrate scan
npx syncanix integrate plan
npx syncanix integrate apply

Lire un catalogue depuis le terminal

Listez ce que contient un fichier de catalogue — filtré par classe de risque, par méthode, par framework —, comparez-en deux, ou exportez un rapport de conformité listant chaque capacité avec son risque et ce qu’elle touche. Utile en revue, et l’export est un document remettable à qui le demande.

npx syncanix catalog list --side-effect destructive
npx syncanix catalog diff ./before.json ./after.json
npx syncanix catalog compliance --format md

La même commande peut lire ou modifier le nom et la description servis à l’agent pour une capacité — la formulation en langage clair que voit la personne qui approuve une action. Pratique pour corriger une description maladroite sans ouvrir le tableau de bord.

Lire ce que l’agent a le droit de faire

Trois commandes en lecture seule pour les questions d’un audit : chaque capacité avec son état d’activation et sa classe de risque, tout changement de capacité en attente d’un second approbateur, et les clés d’API émises par votre espace de travail — préfixes uniquement, jamais un secret.

npx syncanix governance list
npx syncanix approvals
npx syncanix keys list

Environnement de développement local

Lance une page locale qui intègre le widget face à un backend de développement et se recharge à chaud quand votre catalogue change. Des options permettent de définir le port, l’origine du backend, la source du widget, la clé publiable et le chemin du catalogue.

npx syncanix dev --port 4321

Diagnostiquez votre configuration

Vérifie votre environnement pour les problèmes courants — version de Node, framework détecté, configuration valide et clé d’API résoluble. Elle se termine avec un code non nul en cas de problème.

npx syncanix doctor

Enregistrer un serveur MCP externe

Si votre espace de travail exécute déjà son propre serveur MCP, enregistrez-le pour que Syncanix puisse lui transmettre les appels d’outils. Vous devrez être connecté ; l’identifiant est stocké en sécurité et jamais renvoyé.

npx syncanix byomcp register --server-url https://mcp.example.com

Surcouches de catalogue en tant que code

Gérez une surcouche syncanix.yaml versionnée : init en crée une, validate la vérifie, et apply la fusionne sur un catalogue découvert.

npx syncanix yaml init
npx syncanix yaml validate
npx syncanix yaml apply --catalog ./.syncanix/catalog.json

Version

Affiche les versions de la CLI, de Node et de build — pratique pour signaler un problème.

npx syncanix version

Étapes suivantes