Zum Hauptinhalt springen

Die CLI installieren

Mit der Almirant-CLI kannst du jedes Repository mit wenigen Befehlen mit deinem Projekt verbinden. Sie automatisiert die Erstellung von .mcp.json, kopiert die Skill-Vorlagen und richtet die Authentifizierung ein, ohne dass du Schlüssel manuell kopieren und einfügen musst.

Voraussetzungen​

Schritt 1: Die CLI installieren​

Installiere die CLI global:

npm i -g almirant

Prüfe, ob die Installation erfolgreich war:

almirant --version

Schritt 2: Anmelden​

Authentifiziere dein Konto über den Browser:

almirant login

Dieser Befehl öffnet deinen Browser, um den OAuth-Flow abzuschließen. Danach wird dein API key sicher in ~/.almirant/config.json gespeichert.

Info

Du musst dich nur einmal anmelden. Die Anmeldedaten werden automatisch in allen deinen Projekten wiederverwendet.

Schritt 3: Dein Repository verknüpfen​

Wechsle in das Stammverzeichnis deines Repositorys und führe aus:

almirant link

Die CLI:

  1. Verwendet die im vorherigen Schritt gespeicherten Anmeldedaten
  2. Zeigt deine Projekte an, damit du eines auswählst
  3. Erstellt die Datei .mcp.json mit der korrekten Konfiguration
  4. Kopiert die Skill-Vorlagen nach .agents/skills/
  5. Konfiguriert optional deine Shell (PATH)
Info

Wenn du einen vollständigen Ablauf bevorzugst, ohne vorher almirant login ausgeführt zu haben, verwende stattdessen almirant init. Dieser Befehl führt dich in einem Ablauf Schritt für Schritt durch Authentifizierung und Konfiguration.

Schritt 4: Die Verbindung prüfen​

Öffne Claude Code im Projektverzeichnis und frage:

> Liste meine Almirant-Work-Items auf

Wenn alles korrekt konfiguriert ist, antwortet Claude mit den Work Items deines Projekts.

Nächster Schritt​

Dein Repository ist jetzt verbunden. Fahre mit Dein erster KI-Workflow fort, um eine vollständige Aufgabe mit KI aus deiner IDE zu implementieren.

Weitere Details zu jedem Befehl findest du in der CLI-Referenz.