CLI installieren

Die Kommandozeile flowagent liest und ändert die Daten einer Organisation im Flow Agent direkt aus dem Terminal. Sie nutzt den MCP-Server mit denselben Werkzeugen und Berechtigungen wie jeder andere MCP-Client. Für den Download ist kein GitHub-Konto nötig.

Voraussetzung

Die CLI funktioniert nur in Organisationen, in denen eine Administratorin oder ein Administrator der Organisation den CLI-Zugang eingeschaltet hat. Ohne diese Freigabe lässt sich die CLI installieren, die Anmeldung scheitert aber.

Installation

macOS und Linux, im Terminal:

curl -fsSL https://www.evidentflow.app/cli/install.sh | sh

Windows, in PowerShell:

irm https://www.evidentflow.app/cli/install.ps1 | iex

Beide Befehle laden das Installationsprogramm der neuesten Version. Es legt flowagent in $XDG_BIN_HOME ab, sonst in ~/.local/bin (unter Windows %USERPROFILE%\.local\bin), und ergänzt den Ordner bei Bedarf im PATH. Danach ein neues Terminal öffnen und mit flowagent --version prüfen.

Updates installiert flowagent update; flowagent update --check zeigt nur, ob es eine neuere Version gibt.

Angemeldete Nutzerinnen und Nutzer finden den passenden Befehl und einen Download für ihre Plattform auch im Flow Agent unter Einstellungen → CLI.

Installation mit Homebrew

Unter macOS und Linux lässt sich die CLI auch mit Homebrew installieren:

brew install murakamyadvisory/tap/flowagent

Updates kommen dann mit brew upgrade flowagent, nicht mit flowagent update.

Manueller Download

Alternativ lassen sich die Archive direkt herunterladen. Sie liegen im öffentlichen Repository murakamyadvisory/flowagent-cli; die Links unten zeigen immer auf die neueste Version.

Plattform	Prozessor	Archiv
Linux (glibc)	x64	flowagent-cli-x86_64-unknown-linux-gnu.tar.xz
Linux (glibc)	arm64	flowagent-cli-aarch64-unknown-linux-gnu.tar.xz
Linux (statisch/musl, z. B. Alpine)	x64	flowagent-cli-x86_64-unknown-linux-musl.tar.xz
Linux (statisch/musl, z. B. Alpine)	arm64	flowagent-cli-aarch64-unknown-linux-musl.tar.xz
macOS (Intel)	x64	flowagent-cli-x86_64-apple-darwin.tar.xz
macOS (Apple Silicon)	arm64	flowagent-cli-aarch64-apple-darwin.tar.xz
Windows	x64	flowagent-cli-x86_64-pc-windows-msvc.zip
Windows	arm64	flowagent-cli-aarch64-pc-windows-msvc.zip

Beispiel für macOS und Linux; TARGET auf die eigene Plattform aus der Tabelle setzen:

TARGET=aarch64-apple-darwin
BASE=https://github.com/murakamyadvisory/flowagent-cli/releases/latest/download
curl -fsSLO "$BASE/flowagent-cli-$TARGET.tar.xz"
curl -fsSLO "$BASE/flowagent-cli-$TARGET.tar.xz.sha256"
shasum -a 256 -c "flowagent-cli-$TARGET.tar.xz.sha256"   # Linux: sha256sum -c
tar -xJf "flowagent-cli-$TARGET.tar.xz"
mkdir -p ~/.local/bin
install -m 0755 "flowagent-cli-$TARGET/flowagent" ~/.local/bin/flowagent
flowagent --version

Unter Windows das .zip entpacken und flowagent.exe in einen Ordner legen, der im PATH steht.

Prüfsumme prüfen

Zu jedem Archiv gehört eine Datei mit derselben Endung plus .sha256; zusätzlich listet sha256.sum in jeder Version alle Prüfsummen. Die Prüfung im Verzeichnis des Downloads:

# macOS
shasum -a 256 -c flowagent-cli-aarch64-apple-darwin.tar.xz.sha256
# Linux
sha256sum -c flowagent-cli-x86_64-unknown-linux-gnu.tar.xz.sha256

Unter Windows in PowerShell; das Ergebnis muss True sein:

$file = "flowagent-cli-x86_64-pc-windows-msvc.zip"
$expected = ((Get-Content "$file.sha256") -split '\s+')[0]
(Get-FileHash $file -Algorithm SHA256).Hash -eq $expected

Hinweise zu macOS und Windows

• macOS: Die Programme sind mit einer Developer ID („Erwins Enkel“) signiert und von Apple notarisiert. Auch nach einem Download über den Browser startet flowagent deshalb im Terminal ohne Gatekeeper-Sperre. Im Terminal starten, nicht per Doppelklick im Finder: Den blockiert macOS bei Kommandozeilenprogrammen auch dann, wenn sie notarisiert sind.
• Windows: Die Programme sind nicht signiert. Beim ersten Start kann SmartScreen warnen; über „Weitere Informationen“ → „Trotzdem ausführen“ lässt sich die CLI starten.

Erste Anmeldung

flowagent login            # öffnet die Freigabeseite im Browser
flowagent login --device   # ohne lokalen Browser (SSH, Container): Code auf einem anderen Gerät bestätigen
flowagent whoami           # zeigt Profil, Nutzer und Berechtigungen und prüft die Anmeldung

Eine Anmeldung gilt für genau eine Organisation, die auf der Freigabeseite gewählt wird. Standardmäßig verbindet sich die CLI mit https://www.evidentflow.app. Mit flowagent login --write lässt sich zusätzlich Schreibzugriff anfordern, sofern er für die Organisation freigeschaltet ist.

Alle Befehle zeigt flowagent --help. Die Werkzeuge hinter den Befehlen beschreibt die Übersicht zum MCP-Server.