Installation

Die prokodo CLI ist über drei Installationsmethoden verfügbar. Wähle die, die am besten zu deinem Workflow passt.

npm / pnpm / yarn

Voraussetzungen

Voraussetzung	Version
Node.js	≥ 22
npm / pnpm / yarn	aktuelle Version

tipp

Nicht sicher, welche Version installiert ist? Führe node --version aus. Falls Node 22 benötigt wird, verwende nvm: nvm install 22 && nvm use 22.

Global installieren

npm install -g @prokodo/cli

# oder mit pnpm
pnpm add -g @prokodo/cli

# oder mit yarn
yarn global add @prokodo/cli

Installation überprüfen:

prokodo --version

Die aktuelle Versionsnummer sollte auf stdout ausgegeben werden.

Ohne globale Installation (npx)

Die CLI lässt sich auch ohne globale Installation ausführen:

npx @prokodo/cli --help

Aktualisieren

npm update -g @prokodo/cli

Deinstallieren

npm uninstall -g @prokodo/cli

---

Homebrew

Voraussetzungen: macOS 12 Monterey oder neuer · Homebrew

Node.js wird automatisch als Homebrew-Abhängigkeit installiert — ein separates Node-Setup ist nicht erforderlich.

# 1. prokodo Tap hinzufügen (einmalig)
brew tap prokodo-agency/tap

# 2. CLI installieren
brew install prokodo-cli

# 3. Überprüfen
prokodo --version
prokodo doctor

Aktualisieren

brew update && brew upgrade prokodo-cli

Deinstallieren

brew uninstall prokodo-cli
brew untap prokodo-agency/tap  # optional — entfernt den Tap vollständig

---

Docker

Keine lokale Installation erforderlich. Das offizielle Image aus der GitHub Container Registry verwenden.

# Beliebige Befehle ohne globale Installation ausführen
docker run --rm ghcr.io/prokodo-agency/prokodo-cli:latest --help

# Lokales Projekt verifizieren (Arbeitsverzeichnis einbinden)
docker run --rm \
  -e PROKODO_API_KEY=pk_live_... \
  -v "$PWD":/workspace -w /workspace \
  ghcr.io/prokodo-agency/prokodo-cli:latest verify

tipp

PROKODO_API_KEY als Umgebungsvariable übergeben, anstatt prokodo auth login innerhalb des Containers zu verwenden — per prokodo auth login gespeicherte Zugangsdaten werden im Host-Dateisystem abgelegt und stehen im Container standardmäßig nicht zur Verfügung.

---

Umgebung prüfen

Nach der Installation über eine der genannten Methoden den eingebauten Gesundheitscheck ausführen:

prokodo doctor

Erwartete Ausgabe (grüne Häkchen für alle fünf Prüfungen):

✓  Node version               22.x.x (erforderlich ≥ 22)
✗  API key configured         Quelle: keine
✗  .prokodo/config.json       Keine Konfigurationsdatei im aktuellen Verzeichnis
…

Die Prüfungen API key configured und .prokodo/config.json schlagen fehl, bis die Authentifizierung abgeschlossen ist — das ist erwartet.