Installation

AgentFlow is a Go CLI that ties together specs, local investigation, git worktrees, external coding agents, and validation commands. The installation path is deliberate: you get a single binary, point it at a repository, and the tool owns the lifecycle of runs, worktrees, and state on disk. This page walks through building or placing that binary, initializing .agentflow/ in a project, and confirming that git, config, and agent commands line up before you run work.

Requirements

Optional: Ollama for local enrichment or routing, and a Notion token for sync (NOTION_TOKEN).

Homebrew (macOS / Linux)

brew tap LaProgrammerie/tap
brew install agentflow
agentflow version

The formula is published from LaProgrammerie/homebrew-tap when a release tag is pushed.

Manual install (released binary)

Download archives and checksums from GitHub Releases. Archive names follow GoReleaser conventions, for example agentflow_Darwin_arm64.tar.gz, agentflow_Linux_x86_64.tar.gz, or 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

Replace VERSION, the archive name, and the install path for your OS and CPU architecture.

Install from source

Clone the repository, build with the project Makefile, and use the binary under bin/:

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

Add bin/ to your PATH, or copy bin/agentflow into any directory that is already on PATH.

Initialize a repository

From your project root, run agentflow init. The command scaffolds the local AgentFlow surface area so later commands share one config file and one SQLite database.

agentflow init

This creates:

• .agentflow/ — config, SQLite state, runs, worktrees
• .agentflow/config.yaml — copied from config.yaml.example when missing
• .agentflow/state.sqlite — run and task bookkeeping

Ensure .agentflow/state.sqlite and .agentflow/worktrees/ are listed in .gitignore. init prints a reminder because those paths must not be committed.

Verify setup

After any install path (Homebrew, release binary, or make build), run agentflow doctor. Doctor exercises git, checks that config exists, confirms agent commands resolve on PATH, and surfaces common misconfigurations before you spend time on a failing work run.

agentflow doctor

Fix anything it reports before running work.

Configuration

Copy and edit the example when you need custom agents, budgets, or routing:

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

For every YAML block and default, see Configuration file.

Next steps

Continue with Quickstart, then walk an end-to-end run in First workflow.