Installation

AgentFlow est une CLI Go qui relie specs, investigation locale, worktrees Git, agents de codage externes et commandes de validation. La voie d’installation est réfléchie : vous obtenez un binaire unique, le pointez sur un dépôt, et l’outil gère le cycle de vie des runs, worktrees et état sur disque. Cette page couvre la compilation ou le placement du binaire, l’initialisation .agentflow/ dans un projet, et la confirmation que Git, la config et les commandes agents s’alignent avant un work.

Prérequis

Optionnel : Ollama pour enrichissement local ou routage, et jeton Notion pour la synchro (NOTION_TOKEN).

Homebrew (macOS / Linux)

brew tap LaProgrammerie/tap
brew install agentflow
agentflow version

La formule est publiée dans LaProgrammerie/homebrew-tap à chaque tag de release.

Installation manuelle (binaire publié)

Téléchargez archives et sommes depuis GitHub Releases. Noms d’archives type GoReleaser : agentflow_Darwin_arm64.tar.gz, agentflow_Linux_x86_64.tar.gz, agentflow_Windows_arm64.zip, etc.

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

Adaptez VERSION, le nom d’archive et le chemin d’installation à votre OS et CPU.

Installation depuis les sources

Clonez le dépôt, compilez avec le Makefile du projet et utilisez le binaire sous bin/ :

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

Ajoutez bin/ au PATH, ou copiez bin/agentflow dans tout répertoire déjà présent dans PATH.

Initialiser un dépôt

Depuis la racine de votre projet, lancez agentflow init. La commande génère la surface locale AgentFlow pour que les commandes suivantes partagent un fichier de configuration et une base SQLite.

agentflow init

Crée :

• .agentflow/ — config, état SQLite, runs, worktrees
• .agentflow/config.yaml — copie de config.yaml.example lorsqu’il manque
• .agentflow/state.sqlite — suivi runs et tâches

Listez .agentflow/state.sqlite et .agentflow/worktrees/ dans .gitignore. init rappelle qu’ils ne doivent pas être versionnés.

Vérifier l’installation

Après toute voie d’installation (Homebrew, binaire release ou make build), exécutez agentflow doctor. Doctor vérifie Git, la présence de la config, la résolution des commandes agents sur PATH, et signale les pièges fréquents avant de passer du temps sur un work bloqué.

agentflow doctor

Corrigez ce qu’il signale avant d’utiliser work.

Configuration

Copiez l’exemple et éditez-le pour agents, budgets ou routage personnalisés :

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

Pour chaque bloc YAML et défaut par défaut, voir Fichier de configuration.

Étapes suivantes

Poursuivez avec Démarrage rapide, puis enchaîne un run bout en bout avec Premier workflow.