Référence des commandes
Les commandes qui parlent à CiteMe (audit, apply, projects, use, suggestions, agent) exigent d'être connecté (citeme login). demo, llms-txt, completions, update, version et config fonctionnent sans compte. Les routes appelées sont sous https://app.citeme.io/api/v1/cli. Les commandes qui agissent sur une marque utilisent celle choisie par citeme use, ou l'option -p, --project <id>. Les commandes, options et identifiants gardent le mot project (citeme projects, --project, projectId).
Compte et marque
| Commande | Ce qu'elle fait |
|---|---|
citeme login [--no-browser] | Se connecte et enregistre la clé (/auth, /auth/code, /auth/exchange) |
citeme logout | Supprime la clé enregistrée |
citeme whoami | Affiche l'utilisateur connecté (/validate) |
citeme status | Connexion, marque sélectionnée et chemin de la configuration |
citeme config | Affiche le chemin du fichier de configuration |
citeme projects / citeme projects list [--json] | Liste les marques de l'organisation (/projects). Avec --json : { "projects": [...], "selected": ... } |
citeme use [projectId] | Choisit la marque des commandes suivantes |
Analyse du code
| Commande | Options | Ce qu'elle fait |
|---|---|---|
citeme audit | -u, --url <url>, -v, --verbose, --json, --threshold <score>, -p, --project <id>, --wait | Analyse le dépôt courant (framework détecté, jusqu'à 100 fichiers) et envoie le résultat à POST /audit : score technique, problèmes, suggestions. Avec une marque, met aussi en file un audit GEO du site, --wait attend son score. --threshold fait sortir en code 2 sous le score de l'analyse du code, utile en CI (jamais le score GEO). --json imprime le résultat, après l'attente de --wait. Ces audits comptent dans le quota d'audits du dashboard, voir Forfaits |
citeme apply | -a, --audit-id <id>, --all, --dry-run | Applique dans votre code les patchs techniques approuvés (/patches, puis /patches/:id/applied). Fait des sauvegardes et les restaure en cas d'échec. --dry-run montre les changements sans les écrire |
citeme llms-txt generate | -u, --url <url>, -o, --out <path> (défaut llms.txt), --stdout | Construit un llms.txt à partir des pages du dépôt |
citeme llms-txt validate [path] | Vérifie un llms.txt existant par rapport à la spécification | |
citeme demo | Audit d'exemple sur des données fictives, sans compte |
Suggestions
| Commande | Options | Ce qu'elle fait |
|---|---|---|
citeme suggestions | Menu interactif | |
citeme suggestions list | -s, --status (PENDING,APPROVED,PUBLISHED,REJECTED), -t, --type, -l, --limit (défaut 20), --json, -p, --project | Liste les suggestions (/suggestions) |
citeme suggestions view <id> | Affiche une suggestion | |
citeme suggestions approve <id> / reject <id> | Change son statut. Approuver une suggestion technique ne modifie pas le code : citeme apply l'écrira ensuite |
Agent des Actions
| Commande | Ce qu'elle fait |
|---|---|
citeme agent register -p <marque> [-n <nom>] | Enregistre cette machine comme agent d'une marque (/agents/register) |
citeme agent run | Boucle qui récupère les jobs cli.* des workflows (/jobs/next), les exécute en local et renvoie le résultat (/jobs/:id/result) |
citeme agent status | État de l'agent de cette machine |
Divers
| Commande | Ce qu'elle fait |
|---|---|
citeme completions [bash|zsh|fish] | Imprime le script de complétion |
citeme update [--check] | Met la CLI à jour, ou vérifie seulement |
citeme version ou citeme -V, citeme help [commande] | Version et aide |
Sortie JSON
--json existe sur audit, projects list et suggestions list. En cas d'erreur, ces commandes impriment { "error": "message" } sur la sortie standard et sortent en code 1, sauf audit qui suit les codes de sortie.
Codes de sortie de citeme audit
| Code | Sens |
|---|---|
0 | L'audit a tourné et aucun cas ci-dessous ne s'applique |
1 | Autre erreur : analyse, réseau, API |
2 | Le score de l'analyse du code est sous --threshold |
3 | Pas connecté, ou clé refusée |
4 | L'audit GEO a échoué (--wait) |
5 | L'audit GEO tournait encore quand --wait a abandonné |
Quand plusieurs cas s'appliquent, le premier de 4, 5, 2 l'emporte.