CLI CiteMe
citeme est la ligne de commande de CiteMe, publiée sous @citeme-io/cli. Elle analyse le code d'un dépôt, applique les suggestions techniques approuvées, génère un llms.txt et fait tourner votre machine comme agent des Actions. Elle demande Node.js 18 ou plus récent et un forfait payant (voir Forfaits).
npm install -g @citeme-io/cli
citeme login
Se connecter
citeme login ouvre votre navigateur sur CiteMe, puis enregistre une clé sur votre machine. citeme login --no-browser demande l'email et le mot de passe dans le terminal. La connexion expire au bout de 5 minutes si vous ne la terminez pas.
- La clé expire au bout de 90 jours : relancez
citeme login. - Chaque
citeme logincrée sa propre clé. Se reconnecter, sur ce poste ou sur un autre, ne révoque aucune clé existante, ni celle de votre CI ni celle de l'extension Chrome. Les clés en cours sont listées, et se révoquent, dans Réglages → Outils développeur, section Outils connectés. - Les droits suivent votre rôle dans l'organisation : un Lecteur lit, les commandes qui modifient quelque chose sont refusées. Une personne invitée sur une seule marque, sans siège dans l'organisation, ne peut pas se connecter.
citeme configaffiche l'emplacement du fichier de configuration,citeme whoamietciteme statusl'état de la connexion,citeme logoutsupprime la clé.- Pour un CI ou un agent sans navigateur, exportez la clé dans
CITEME_API_KEY.CITEME_API_URLchange l'URL de l'API etCITEME_PROJECT_IDla marque par défaut.
cm_La clé de citeme login ne fonctionne que sur /api/v1/cli/* et sur le serveur MCP hébergé. Elle est refusée par /api/v1/projects/*, qui exige une clé cm_ du dashboard. Voir Authentification. Pour piloter CiteMe depuis un agent, citeme login suffit : ne cherchez pas de clé API.
Dans un CI
Lancez citeme login une fois sur votre poste, puis copiez apiKey depuis le fichier affiché par citeme config dans un secret du dépôt, par exemple CITEME_API_KEY. Cette clé reste valide 90 jours, même si vous vous reconnectez ensuite : chaque citeme login crée une nouvelle clé sans toucher aux précédentes. Révoquez-la dans Outils connectés quand le CI n'en a plus besoin, puis remplacez le secret.
L'action GitHub prête à l'emploi analyse le code à chaque pull request :
- uses: CiteMe/cli-citeme/actions/geo-audit@cli-v0.7.0
with:
api-key: ${{ secrets.CITEME_API_KEY }}
threshold: 60
Elle échoue sous threshold et expose code-score (le score de l'analyse du code, pas le score GEO du dashboard ; score reste un alias déprécié), technical-score, issues et passed. Elle ne lance un audit GEO qu'avec run-geo-audit: true et project, car chaque audit consomme votre quota. Une clé cm_ est refusée.
Sans l'action, citeme audit --json --threshold 60 avec CITEME_API_KEY dans l'environnement fait la même chose. Les codes de sortie sont dans la référence des commandes.
Ce que la CLI sait faire, et ce qu'elle ne sait pas faire
Elle couvre le code, les suggestions et les Actions. Elle ne couvre pas encore le côté GEO de la plateforme : pas de commande pour créer ou lister des prompts et des thèmes, choisir les questions d'un audit, suivre son avancement ou lire ses résultats (réponses par question, citations, concurrents). C'est suivi dans cli-citeme#57.
citeme audit est une analyse du code du dépôt courant, pas l'audit GEO du dashboard. Quand une marque est sélectionnée, elle met aussi en file un audit GEO du site en ligne (sur les prompts actifs de la marque), et --wait attend son score. C'est tout : pour le détail des réponses, utilisez le MCP ou l'API.
Pour créer des prompts, lancer un audit et lire ses réponses depuis un agent, utilisez le serveur MCP hébergé : la recette est dans Piloter CiteMe depuis un agent IA.
Paquet MCP local
@citeme-io/mcp est un serveur MCP qui tourne sur votre machine en stdio, pour les clients qui ne savent lancer qu'un processus local (Claude Desktop, Cursor, Claude Code). Il réutilise la connexion de citeme login.
npm install -g @citeme-io/cli @citeme-io/mcp
claude mcp add citeme -- npx -y @citeme-io/mcp
Une fois connecté, il reprend les 47 outils du serveur hébergé, sous les mêmes noms et avec les mêmes arguments, audits compris (run_audit, get_audit, list_audits), ainsi que ses quatre prompts prêts à l'emploi (why_am_i_losing, what_should_i_fix_first, am_i_improving, who_is_reading_my_site). Il y ajoute quatre outils à lui, qui appellent /api/v1/cli/* : get_project, list_workflows, run_workflow et get_workflow_run. Aucun de ces outils locaux ne masque un outil hébergé. Voir Connecter votre assistant.
run_workflow et la commande citeme agent peuvent modifier des fichiers et ouvrir des pull requests sur la machine qui exécute l'agent : n'y branchez que des workflows que vous avez relus.