Installation

AgentFlow ist eine Go-CLI, die Specs, lokale Investigation, Git-Worktrees, externe Coding-Agenten und Validierungsbefehle verbindet. Der Installationsweg ist bewusst schlank: eine Binärdatei, ein Repository als Arbeitskontext — das Tool führt Laufzyklen, Worktrees und Persistenz auf der Platte. Diese Seite behandelt Build oder Platzierung der Binärdatei, Initialisierung von .agentflow/ und den Check von Git, Konfiguration und Agent-Befehlen vor dem ersten work.

Anforderungen

Optional: Ollama für lokales Routing oder Enrichment; Notion-Token für Sync (NOTION_TOKEN).

Homebrew (macOS / Linux)

brew tap LaProgrammerie/tap
brew install agentflow
agentflow version

Die Formel wird bei jedem Release-Tag in LaProgrammerie/homebrew-tap veröffentlicht.

Manuelle Installation (Release-Binary)

Archive und Prüfsummen von GitHub Releases laden. Archivnamen folgen GoReleaser, z. B. agentflow_Darwin_arm64.tar.gz, agentflow_Linux_x86_64.tar.gz, agentflow_Windows_arm64.zip.

VERSION=v0.1.0
curl -LO "https://github.com/LaProgrammerie/hyper-fast-builder/releases/download/${VERSION}/checksums.txt"
curl -LO "https://github.com/LaProgrammerie/hyper-fast-builder/releases/download/${VERSION}/agentflow_Darwin_arm64.tar.gz"
sha256sum -c checksums.txt
tar -xzf agentflow_Darwin_arm64.tar.gz
sudo install -m 755 agentflow /usr/local/bin/agentflow
agentflow version

VERSION, Archivname und Installationspfad an OS und CPU anpassen.

Installation aus dem Quellcode

Repository klonen, mit dem Projekt-Makefile bauen, die Binärdatei unter bin/ verwenden:

git clone https://github.com/LaProgrammerie/hyper-fast-builder.git
cd hyper-fast-builder
make build
./bin/agentflow version

bin/ zum PATH hinzufügen oder bin/agentflow an einen Ort kopieren, der bereits auf PATH liegt.

Repository initialisieren

Vom Projektroot agentflow init ausführen. Der Befehl legt die lokale AgentFlow-Oberfläche an, damit später alle Kommandos dieselbe Konfiguration und dieselbe SQLite-Datenbank nutzen.

agentflow init

Es entstehen unter anderem:

• .agentflow/ — Konfiguration, SQLite, Runs, Worktrees
• .agentflow/config.yaml — aus config.yaml.example, falls noch nicht vorhanden
• .agentflow/state.sqlite — Buchführung für Läufe und Tasks

Tragen Sie .agentflow/state.sqlite und .agentflow/worktrees/ in .gitignore ein. init erinnert daran — diese Artefakte gehören nicht ins Versionsarchiv.

Einrichtung prüfen

Nach jeder Installationsart (Homebrew, Release-Binary oder make build): agentflow doctor. Der Befehl prüft Git, die Existenz der Konfiguration, ob Agent-Befehle auf PATH auflösbar sind, und häufige Fehlkonfigurationen — bevor Sie Zeit in einen fehlschlagenden work-Lauf investieren.

agentflow doctor

Gemeldete Punkte beheben, bevor Sie work ausführen.

Konfiguration

Bei Bedarf die Beispieldatei kopieren und anpassen:

cp .agentflow/config.yaml.example .agentflow/config.yaml

Alle Blöcke und Defaults: Konfigurationsdatei.

Nächste Schritte

Weiter mit Schnellstart, dann ein durchgängiger Ablauf unter Erster Workflow.