Aller au contenu principal

Référence des commandes

Référence

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​

CommandeCe qu'elle fait
citeme login [--no-browser]Se connecte et enregistre la clé (/auth, /auth/code, /auth/exchange)
citeme logoutSupprime la clé enregistrée
citeme whoamiAffiche l'utilisateur connecté (/validate)
citeme statusConnexion, marque sélectionnée et chemin de la configuration
citeme configAffiche 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​

CommandeOptionsCe qu'elle fait
citeme audit-u, --url <url>, -v, --verbose, --json, --threshold <score>, -p, --project <id>, --waitAnalyse 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-runApplique 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), --stdoutConstruit 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 demoAudit d'exemple sur des données fictives, sans compte

Suggestions​

CommandeOptionsCe qu'elle fait
citeme suggestionsMenu interactif
citeme suggestions list-s, --status (PENDING,APPROVED,PUBLISHED,REJECTED), -t, --type, -l, --limit (défaut 20), --json, -p, --projectListe 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​

CommandeCe qu'elle fait
citeme agent register -p <marque> [-n <nom>]Enregistre cette machine comme agent d'une marque (/agents/register)
citeme agent runBoucle 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​

CommandeCe 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​

CodeSens
0L'audit a tourné et aucun cas ci-dessous ne s'applique
1Autre erreur : analyse, réseau, API
2Le score de l'analyse du code est sous --threshold
3Pas connecté, ou clé refusée
4L'audit GEO a échoué (--wait)
5L'audit GEO tournait encore quand --wait a abandonné

Quand plusieurs cas s'appliquent, le premier de 4, 5, 2 l'emporte.

Piloter CiteMe depuis un agent IA →