# Référence des commandes

> Toutes les commandes de la CLI citeme, leurs options, la sortie JSON et les routes qu'elles appellent.

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 un projet utilisent celui choisi par `citeme use`, ou l'option `-p, --project <id>`.

## Compte et projet

| 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, projet sélectionné et chemin de la configuration |
| `citeme config` | Affiche le chemin du fichier de configuration |
| `citeme projects` / `citeme projects list [--json]` | Liste les projets de l'organisation (`/projects`). Avec `--json` : `{ "projects": [...], "selected": ... }` |
| `citeme use [projectId]` | Choisit le projet 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 un projet, met aussi en file un audit GEO du site, `--wait` attend son score. `--threshold` fait sortir en code 1 sous le score donné, utile en CI. `--json` imprime le résultat. Quota mensuel de ces audits : 25 en Starter, 100 en Pro, illimité en Expert |
| `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 <projet> [-n <nom>]` | Enregistre cette machine comme agent d'un projet (`/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`, `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.

**[Piloter CiteMe depuis un agent IA →](../agents.md)**