Démarrer¶

Pour un nouvel utilisateur. Compte une quinzaine de minutes, dont l'essentiel en attente d'extraction.

Prérequis¶

	Pourquoi
Un compte Entra du tenant DYNECO	L'authentification passe par lui, il n'y a aucun mot de passe AIM
Azure CLI	Le CLI y prend son jeton
uv ou Python 3.11+	Pour installer le CLI

Rien d'autre. Ni base de données, ni pandoc, ni clé d'API de modèle : la conversion des documents et l'inférence se font côté serveur.

1. Installer¶

uv tool install https://pkg.prod.aim.dyneco.io/packages/dyneco_aim-0.3.0-py3-none-any.whl

La commande installée s'appelle aim. Pour suivre les mises à jour, ou pour les autres modes d'installation, voir Publier une version.

2. Se connecter¶

az login
aim login \
  --api-url https://api.prod.aim.dyneco.io \
  --audience api://de32b68a-b2c5-4ad0-8e8c-dab234a90901

Attendu

╭───────────────────────── AIM ─────────────────────────╮
│ Connecté en tant que prenom.nom@dyneco.io             │
│ API : https://api.prod.aim.dyneco.io                  │
│ Configuration : /Users/toi/.aim/config.toml           │
╰───────────────────────────────────────────────────────╯

Pourquoi deux valeurs différentes qui se ressemblent

Le CLI demande un jeton pour api://<appId>, mais Entra place le GUID seul dans la revendication aud. Le serveur valide donc le GUID. Les deux chaînes sont normales et différentes.

3. Vérifier¶

aim doctor

Attendu

                        Environnement AIM
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Vérification        ┃ État ┃ Détail                           ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ config              │ ok   │ /Users/toi/.aim/config.toml      │
│ dépôts liés         │ ok   │ 0 dépôt(s)                       │
│ authentification    │ ok   │ prenom.nom@dyneco.io             │
│ clients accessibles │ ok   │ …                                │
└─────────────────────┴──────┴──────────────────────────────────┘

Si « clients accessibles » affiche aucun, c'est normal pour un nouveau compte : il faut qu'un propriétaire t'ajoute. Voir Travailler à plusieurs.

4. Lier un dépôt¶

Place-toi à la racine d'un dépôt du client, puis :

aim link

Cette association est enregistrée dans ~/.aim/config.toml. Elle vaut aussi pour tous les sous-dossiers : tu peux lancer les commandes depuis n'importe où dans l'arborescence sans jamais retaper --client.

5. Récupérer le contexte¶

aim sync

Attendu

Pack : 47 faits, 2 procédures, 0 accessibles via recherche

  ✓ CLAUDE.md
  ✓ .claude/skills/ci-cd-release-runbook/SKILL.md
  ✓ AGENTS.md
  ✓ .github/copilot-instructions.md
  ✓ .github/instructions/go.instructions.md
  …

Ouvre CLAUDE.md et lis-le. Si une règle te paraît fausse, c'est le bon moment pour le dire — voir Onboarder un nouveau client.

Les fichiers générés, faut-il les commiter ?

Oui, si l'équipe du client accepte : les autres développeurs en profitent immédiatement. Non, si c'est ton usage personnel — ajoute-les alors au .git/info/exclude local plutôt qu'au .gitignore partagé.

6. Brancher ton agent¶

aim mcp

La commande crée une clé dédiée et affiche la configuration prête à coller. Voir Brancher un agent de code.

Où vit quoi sur ta machine¶

~/.aim/
├── config.toml      adresse de l'API, audience, dépôts liés
└── cache/
    └── <client>.json  dernier pack reçu, pour le mode hors ligne

Aucune donnée client n'est stockée ailleurs que dans ce cache, qui ne contient que des packs déjà compilés. Ce dossier est propre à la machine et n'a pas besoin d'être sauvegardé.