Commandes CLI¶
Toutes les commandes se lancent depuis n'importe où. Quand le client n'est pas précisé, il est déduit dans cet ordre :
- l'option
--client; - le dépôt courant, s'il a été lié par
aim link(les sous-dossiers héritent) ; - le client par défaut de la configuration ;
- une question, si plusieurs clients sont accessibles.
Configuration¶
aim login¶
Enregistre l'API dans ~/.aim/config.toml et vérifie l'authentification. Sans
options, demande l'URL.
aim doctor¶
Vérifie la configuration locale, l'authentification et la liste des clients accessibles. Premier réflexe en cas de problème.
aim version¶
Clients¶
aim client new [slug]¶
Assistant interactif : identifiant, nom, description, mission. La mission oriente l'extraction — voir Onboarder un nouveau client.
aim client list¶
Slug, nom, rôle, nombre de documents et de faits, mission.
aim client show [-c <slug>]¶
Détail d'un client et liste de ses documents, avec la nature déduite et l'auteur de l'ingestion.
Ingestion¶
aim add¶
| Option | Effet |
|---|---|
<chemins…> |
Fichiers ou dossiers. Les dossiers sont parcourus récursivement |
--repo <chemin> |
Analyse un dépôt : six signaux calculés localement |
--no-extract |
Dépose sans extraire. Utile pour tout déposer puis extraire une fois |
Les fichiers sont envoyés bruts et convertis côté serveur. Le code d'un dépôt, lui, ne quitte jamais la machine.
aim extract [-c <slug>] [--force]¶
Relance l'extraction. Sans --force, les documents inchangés sont sautés.
aim consolidate [-c <slug>]¶
Passe lexicale puis passe LLM : fusionne les redites, signale les contradictions.
Faits¶
aim facts¶
--full affiche le détail, la provenance et les identifiants.
aim search <requête> [-c <slug>] [--limit N]¶
Recherche plein texte dans les faits du client.
aim review [-c <slug>] [--type <type>]¶
Revue interactive des faits candidate et conflicting, un par un, avec leur
provenance. Touches : a approuver, r rejeter, e éditer l'énoncé, s sauter,
q quitter.
Livraison¶
aim link [-c <slug>] [--path <dépôt>]¶
Associe un dépôt à un client, une fois pour toutes. Enregistré dans
~/.aim/config.toml.
aim sync¶
| Option | Défaut | Effet |
|---|---|---|
--out |
racine du dépôt courant | Dossier cible |
--targets |
claude-code,opencode,copilot |
Agents à alimenter |
--offline |
— | Force le dernier pack en cache |
Bascule automatiquement sur le cache si l'API est injoignable — mais jamais sur une erreur applicative. Voir Travailler hors ligne.
Accès¶
aim member list [-c <slug>]¶
aim member add <oid> [--label <nom>] [--role <rôle>] [-c <slug>]¶
Rôles : reader (défaut), contributor, owner.
Clés d'API¶
aim key create [--name <nom>]¶
Crée une clé pour un agent. Affichée une seule fois.
aim key list¶
aim key revoke <id>¶
Agents¶
aim mcp [--name <nom>] [--no-create-key]¶
Affiche la configuration MCP prête à coller. Crée une clé dédiée par défaut ;
--no-create-key laisse un emplacement à remplir.
Variables d'environnement¶
| Variable | Effet |
|---|---|
AIM_HOME |
Emplacement de la configuration et du cache (défaut ~/.aim) |
Codes de sortie¶
| Code | Sens |
|---|---|
0 |
Succès |
1 |
Erreur : configuration absente, API injoignable sans cache, accès refusé, argument invalide |
Les messages d'erreur partent sur la sortie d'erreur standard, ce qui permet de filtrer proprement dans un script.