Instalación

AgentFlow es una CLI en Go que une specs, investigación local, worktrees de Git, agentes de código externos y comandos de validación. La ruta de instalación es deliberada : obtiene un binario único, lo orienta al repositorio y la herramienta gestiona el ciclo de vida de ejecuciones, worktrees y estado en disco. Esta página cubre cómo construir o colocar el binario, inicializar .agentflow/ en el proyecto y comprobar que Git, configuración y comandos agente están alineados antes de lanzar work.

Requisitos

Opcional : Ollama para enriquecimiento o enrutado local y token Notion para sincronización (NOTION_TOKEN).

Homebrew (macOS / Linux)

brew tap LaProgrammerie/tap
brew install agentflow
agentflow version

La fórmula se publica en LaProgrammerie/homebrew-tap con cada tag de release.

Instalación manual (binario publicado)

Descargue archivos y sumas desde GitHub Releases. Nombres tipo 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

Ajuste VERSION, el nombre del archivo y la ruta de instalación a su SO y CPU.

Instalación desde fuentes

Clone el repositorio, compile con el Makefile del proyecto y use el binario bajo bin/ :

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

Añada bin/ al PATH o copie bin/agentflow a cualquier directorio ya incluido en PATH.

Inicializar un repositorio

Desde la raíz del proyecto ejecute agentflow init. Orquesta la superficie local de AgentFlow para que los comandos posteriores compartan un mismo fichero de configuración y SQLite.

agentflow init

Crea :

• .agentflow/ — config, estado SQLite, runs, worktrees
• .agentflow/config.yaml — copia de config.yaml.example cuando falta
• .agentflow/state.sqlite — contabilidad de runs y tareas

Incorpore .agentflow/state.sqlite y .agentflow/worktrees/ a .gitignore. init recuerda que esas rutas no deben versionarse.

Verificar el entorno

Tras cualquier vía de instalación (Homebrew, binario de release o make build), ejecute agentflow doctor. Doctor ejercita git, comprueba que la config existe, que los comandos agente resuelven en PATH, y muestra configuraciones típicamente rotas antes de malgastar tiempo en work.

agentflow doctor

Corrija lo reportado antes de usar work.

Configuración

Copie y edite el ejemplo cuando necesite agentes, presupuestos o enrutado propios :

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

Para cada bloque YAML y valor por defecto consulte Archivo de configuración.

Próximos pasos

Continúe con Inicio rápido y después recorra un ciclo extremo a extremo en Primer workflow.