Aller au contenu principal

Installer le CLI

Le CLI d'Almirant vous permet de connecter n'importe quel dépôt à votre projet avec quelques commandes. Il automatise la création du fichier .mcp.json, copie les skill templates et configure l'authentification, sans avoir à copier-coller des clés manuellement.

Prérequis​

Étape 1 : Installer le CLI​

Installez le CLI globalement :

npm i -g almirant

Vérifiez que l'installation a réussi :

almirant --version

Étape 2 : Se connecter​

Authentifiez votre compte via le navigateur :

almirant login

Cette commande ouvrira votre navigateur pour terminer le flux OAuth. Une fois celui-ci terminé, votre API key sera stockée de manière sécurisée dans ~/.almirant/config.json.

info

Vous n'avez besoin de vous connecter qu'une seule fois. Les identifiants sont réutilisés automatiquement dans tous vos projets.

Étape 3 : Lier votre dépôt​

Accédez à la racine de votre dépôt et exécutez :

almirant link

Le CLI :

  1. Utilisera les identifiants stockés à l'étape précédente
  2. Affichera vos projets afin que vous en sélectionniez un
  3. Générera le fichier .mcp.json avec la bonne configuration
  4. Copiera les skill templates dans .agents/skills/
  5. Configurera éventuellement votre shell (PATH)
info

Si vous préférez un flux complet sans avoir exécuté almirant login auparavant, utilisez almirant init à la place. Cette commande vous guide pas à pas dans l'authentification et la configuration en un seul flux.

Étape 4 : Vérifier la connexion​

Ouvrez Claude Code dans le répertoire du projet et demandez :

> Liste mes work items Almirant

Si tout est correctement configuré, Claude répondra avec les Work Items de votre projet.

Étape suivante​

Votre dépôt est maintenant connecté. Continuez avec Votre premier flux IA pour implémenter une tâche complète avec l'IA depuis votre IDE.

Pour plus de détails sur chaque commande, consultez la Référence du CLI.