Terminal & CI/CD

Ligne de commande (CLI)

Auditez specs et plans en une seule commande, depuis votre terminal.

Lancez des audits de qualité épistémique et des revues de spec sans quitter votre shell — parfait pour les vérifications rapides et les pipelines CI.

Une commande transforme une spec markdown en rapport scoré.

La sortie JSON se branche directement sur vos scripts et gates CI.

Le mode async répond immédiatement : les longs jobs ne bloquent jamais votre shell.

Idéal pour : Les développeurs qui vivent dans le terminal et veulent des audits rapides et scriptables.

Mise en route

Suivez ces étapes pour être opérationnel.

1

Installez le CLI

Clonez le dépôt et installez le CLI globalement.

git clone https://github.com/cvai/cvai-cli.git
cd cvai-cli
npm install -g .
2

Authentifiez-vous

Générez une clé API depuis votre tableau de bord développeur, puis connectez-vous.

# Log in with your API key
cvai login --api-key cvai_ak_your_key_here

# Or set the environment variable
export CVAI_API_KEY=cvai_ak_your_key_here
3

Analysez une spécification

Soumettez un fichier markdown. Ajoutez des options pour la profondeur ou la sortie JSON.

# Submit a spec file for review
cvai review-spec ./my-spec.md

# With options
cvai review-spec ./prd.md --depth quick --json

# Async mode (returns immediately)
cvai review-spec ./spec.md --async
4

Consultez les résultats

Suivez l'état d'un job async, récupérez le rapport complet et vérifiez votre solde.

# Check job status
cvai status <run_id>

# Get full results
cvai result <run_id>

# Check your USD balance
cvai credits

Ligne de commande (CLI) — questions fréquentes

Comment auditer une spécification depuis la ligne de commande avec CVAI ?

Installez la CLI CVAI, authentifiez-vous avec une clé API cvai_ak_ (lancez cvai login ou définissez la variable d'environnement CVAI_API_KEY), puis exécutez cvai review-spec ./my-spec.md. Une seule commande transforme une spécification markdown en rapport noté, et la sortie JSON s'intègre directement dans vos scripts et vos contrôles CI.

Les exécutions de la CLI CVAI peuvent-elles fonctionner en CI sans bloquer mon shell ?

Oui. Le mode asynchrone de la CLI (cvai review-spec ./spec.md --async) renvoie immédiatement pour que les longues tâches ne bloquent jamais votre shell ; vous interrogez ensuite cvai status avec l'identifiant d'exécution et récupérez le rapport complet avec cvai result.