flowfield-core

agent
Security Audit
Warn
Health Pass
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 30 GitHub stars
Code Warn
  • process.env — Environment variable access in runtimes/claude-sdk/build.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

A local workspace for you and your coding agents. Plan across projects, run focused tasks, review outcomes and approve exact code for delivery.

README.md

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.

Reviews (0)

No results found