# CLI CiteMe

> Installer la CLI citeme, se connecter, ce qu'elle fait aujourd'hui et ce qu'elle ne fait pas encore.

Développeurs

`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](../actions/index.md). Elle demande Node.js 18 ou plus récent et un forfait **Starter** ou supérieur.

```bash
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`.
- Une clé est enregistrée par client (CLI, extension Chrome, MCP). Se connecter dans l'un ne déconnecte pas les autres.
- `citeme config` affiche l'emplacement du fichier de configuration, `citeme whoami` et `citeme status` l'état de la connexion, `citeme logout` supprime la clé.
- Pour un CI ou un agent sans navigateur, exportez la clé dans `CITEME_API_KEY`. `CITEME_API_URL` change l'URL de l'API et `CITEME_PROJECT_ID` le projet par défaut.

:::warning Ce n'est pas une clé API `cm_`
La clé de `citeme login` ne fonctionne que sur `/api/v1/cli/*` et sur le [serveur MCP hébergé](../mcp/index.md). Elle est refusée par `/api/v1/projects/*`, qui exige une clé `cm_` du dashboard (forfait Pro). Voir [Authentification](../api/authentication.md). Pour piloter CiteMe depuis un agent, `citeme login` suffit : ne cherchez pas de clé API.
:::

---

## 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](https://github.com/CiteMe/cli-citeme/issues/57).

`citeme audit` est une analyse du code du dépôt courant, pas l'audit GEO du dashboard. Quand un projet est sélectionné, elle met aussi en file un audit GEO du site en ligne (sur les prompts actifs du projet), 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é](../mcp/index.md) : la recette est dans [Piloter CiteMe depuis un agent IA](../agents.md).

---

## 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`.

```bash
npm install -g @citeme-io/cli @citeme-io/mcp
claude mcp add citeme -- npx -y @citeme-io/mcp
```

Il expose ses propres outils, qui appellent `/api/v1/cli/*` : `list_projects`, `get_project`, `get_latest_audit`, `list_suggestions`, `get_suggestion`, `set_suggestion_status`, `list_markets`, `list_topics`, `create_topic`, `create_prompts`, `list_workflows`, `run_workflow` et `get_workflow_run`, ainsi que quatre prompts prêts à l'emploi (`why_am_i_losing`, `what_should_i_fix_first`, `am_i_improving`, `who_is_reading_my_site`). Après connexion, il va chercher une partie des outils analytiques du serveur hébergé. Les outils qui lancent un audit ou lisent ses réponses (`run_audit`, `get_audit`, `list_audits`) sont ceux du serveur hébergé : connectez-vous-y directement. Voir [Connecter votre assistant](../mcp/connect.md#paquet-local).

`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.

---

**[Référence des commandes →](./commands.md)**