Skip to main content

Flowfield

Ship software. Not slop.

A workspace for you and your coding agents.
Shape the plan, build across projects, and bring every outcome through review.

Website · Get started · Documentation

PyPI version Tests Apache 2.0 license

The Coordinator beside task priorities, review and delivered outcomes

The idea is in one conversation. The implementation is in another. An agent needs an answer, a task is waiting on another task, and the reason you chose this approach is buried twenty messages back.

Flowfield gives that work a home. Plan with the Coordinator while workers carry out focused tasks across your existing repositories. Keep shared knowledge in versioned documents, let a Reviewer assess each complete outcome, and answer questions in one Inbox. Code, reports and files stay connected to the work that produced them. You decide which code ships.

Flowfield runs locally and works with Codex, Claude Code and Pi. Choose independently for the Coordinator, Workers and Reviewer.

Get started

Install uv and sign in to a supported coding harness, then:

uv tool install flowfield-core
flowfield serve

Open localhost:8765, create a workspace and choose its agents. Add existing repositories for code work, or start with a report or file task. See Getting started for the walkthrough or Installation for requirements and alternatives.

Upgrading from an earlier database schema requires a fresh data directory. Existing state is preserved but not migrated; read Local storage before updating.

How does Flowfield work?

Ask the Coordinator to organize work and maintain shared context. Each task owns a useful outcome, its history and delivery. Follow Tasks Board, edit documents and respond through Inbox while the same conversation stays beside the work.

💬 Shape the idea
Talk through the problem with the Coordinator. It turns agreed decisions into tasks while the work continues beside the conversation.

🗂️ Connect your projects
Bring your API, application and documentation into one workspace. Link dependent tasks across projects, or create reports and files without a repository.

📚 Give workers the right context
The Coordinator maintains shared documents and selects the sources each task needs. Prepared tasks keep their exact document revisions, and newer revisions stay visible for review.

⚡ Build in parallel
Workers carry out independent tasks in separate checkouts using your tools and checks. Larger tasks can use local subtasks that assemble into one result. Dependent work waits for delivered prerequisites.

📥 Know what needs you
Inbox separates decisions in Needs me, completed outcomes in Delivered and earlier responses in History. Answer a question once and managed work continues when eligible. Task feeds preserve the story.

🔎 Own the finish
The Reviewer assesses the whole task and can request corrections. Inspect or run the result, then approve exact code for delivery to your local branch. Complete reports and files finish after configured review and remain available in Files. Pushing and deployment stay yours.

Screenshots

Workspace board with code, file and report tasks
Tasks
Shared workspace document with revision history
Documents
Retained task files with folders and a file inspector
Files
Inbox with a question and code ready for review
Inbox
Task history with local subtasks, work and whole-task review
Task history
Code result with its diff, checks and review actions
Code review

Contributing

Bug reports, feature requests and feedback are welcome. See CONTRIBUTING.md for issue reporting and contribution policy. Report vulnerabilities through private security reporting.

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

Flowfield is licensed under the Apache License 2.0.

Metadata

Release files for flowfield-core 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flowfield-core 0.6.0
File Size Uploaded Provenance Actions
flowfield_core-0.6.0.tar.gz 76.8 MB Without provenance Details for flowfield_core-0.6.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for flowfield-core 0.6.0
File Interpreter ABI Platform Actions
flowfield_core-0.6.0-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details for flowfield_core-0.6.0-py3-none-manylinux_2_28_x86_64.whl
flowfield_core-0.6.0-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details for flowfield_core-0.6.0-py3-none-manylinux_2_28_aarch64.whl
flowfield_core-0.6.0-py3-none-macosx_13_0_arm64.whl Python 3 none macOS 13.0+ ARM64 Details for flowfield_core-0.6.0-py3-none-macosx_13_0_arm64.whl

Total release size: 178.6 MB

Release files / flowfield_core-0.6.0.tar.gz

Download URL flowfield_core-0.6.0.tar.gz
Size 76.8 MB
Tags Source
SHA-256 checksum
How to use checksums
0d8e1ba67066861bcae22d64d9531a6553f556a000d73e46464cf7aab3201691
BLAKE2b-256 checksum
How to use checksums
64b0c21ff482c74ce233261985c483d5eda8124e827c611d268a62a42ecec5a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / flowfield_core-0.6.0-py3-none-manylinux_2_28_x86_64.whl

Download URL flowfield_core-0.6.0-py3-none-manylinux_2_28_x86_64.whl
Size 39.2 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
c4ff53efdafc43ed14696daba22d476858b6ab85025ea2a5265d00583a115387
BLAKE2b-256 checksum
How to use checksums
5359f06e5cf033aa1a961f6fc267ef3ce6e7131bb1544ec1eec244b4646e9100
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / flowfield_core-0.6.0-py3-none-manylinux_2_28_aarch64.whl

Download URL flowfield_core-0.6.0-py3-none-manylinux_2_28_aarch64.whl
Size 39.1 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
09970dbfb1a4458acf14d4fe22fc989d3da47783c0f27b92e98da2dae69c5ad6
BLAKE2b-256 checksum
How to use checksums
998f82ff3b0f43d9f370530f7e7b6b3bf1885cf2e9d1a78e27bdd156e76835ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / flowfield_core-0.6.0-py3-none-macosx_13_0_arm64.whl

Download URL flowfield_core-0.6.0-py3-none-macosx_13_0_arm64.whl
Size 23.5 MB
Tags Python 3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
9631bb73be7b8f867a5d5d0600e9e63ee189b9a4e9d301c6b44189a5bb4ce7f8
BLAKE2b-256 checksum
How to use checksums
700350d4a84919eea80d21687cc5e0e927b9d97dfdeedb728a9610f369faad1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for flowfield-core 0.6.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page