Skip to main content
With uv installed:
Requires Python 3.12+, macOS 13+ on Apple Silicon or glibc 2.28+ Linux on arm64/x64. If flowfield is missing from PATH, run uv tool update-shell and open a new terminal.

Alternative: pip

Use Python 3.12 or newer in a dedicated virtual environment:
Activate that environment to use the shorter command:

Set up your harnesses

Install and sign in to Codex, Claude Code or Pi on the same machine. Flowfield includes the integrations; code tasks also need Git. Choose Verify installation in Settings → Harnesses. See agent setup if detection, sign-in or model access fails.

Start and stop

The service opens localhost:8765. Use --no-open to keep the browser closed; Ctrl-C stops it. For another port, use flowfield serve --port 8770 and connect clients with flowfield --port 8770 …. Continue with Your first task.

Update

Settings → Updates shows available releases and update commands. Flowfield checks automatically while running; choose Check for updates for a manual check. Disable automatic checks in Settings → Updates or with FLOWFIELD_UPDATE_CHECKS=0. Stop the service before upgrading:
For the pip environment:
Your workspaces and settings are preserved. See the release notes for changes. To review work before the queue starts again, turn off Auto-start worker queue in workspace Workers settings before stopping the service.