Flowfield

A workspace for you and your coding agents, with a board and task feeds.

What is Flowfield?

💬 Plan with the Coordinator
Explore ideas, turn them into milestones and tasks, and refine the plan while workers build. Open a card beside the conversation to discuss its scope or results.

📋 Organize work on the board
Prioritize tasks, track dependencies, and see what’s queued, running or ready for review. Needs you brings questions, blockers and review requests into one place.

🧵 Follow each task in its feed
Keep definitions, progress, tool activity, questions, answers and results together. See what changed and respond to the work that needs your attention.

⚡ Run workers in parallel
Independent tasks run in separate Git checkouts with configurable worker capacity. Dependencies hold work until it’s ready, and each worker uses your project’s tools and checks.

🔎 Review and integrate results
Inspect code changes, try an exact result, and request revisions or approve delivery to your project. Flowfield protects your working changes and keeps approval tied to the code you reviewed.

Install

Install and sign in to Codex CLI or Claude Code or Pi, then:

uv tool install flowfield-core
flowfield serve

The browser opens at localhost:8765. See Installation for the pip alternative.

Choose Add project in the sidebar and select an existing directory, or register it from a terminal:

flowfield project init

Start planning in the Coordinator, or connect a standalone coding agent. Connect the harness you already use: Codex, Claude Code or Pi 1.1+. Choose independently for the Coordinator and workers. Native support ships with Flowfield.

Fits your existing project

Choose an existing repository and use its tools, setup commands and tests. Keep architecture, designs and coding conventions in your repository; Flowfield keeps ongoing work on the board and execution evidence in task feeds.

Workers use separate Git checkouts. You review an exact code result before Flowfield delivers it to your project’s configured branch. Your working changes stay protected.

Documentation

Getting Started · Concepts · CLI · Agents

Build from source

Requires Python 3.12+, uv, Node 24+, pnpm 11.19.0 and Bun 1.3.11. Set FLOWFIELD_BUILD_BUN to the Bun executable before make setup.

make setup
pnpm --dir web build
uv run flowfield serve

See CONTRIBUTING.md for checks and issue reporting. Report vulnerabilities through private security reporting.

License

Apache License 2.0.