Flowfield does not open
Runflowfield serve in a terminal and read its output. Keep that terminal open while using the browser interface. If the command is missing, follow the PATH instructions in Installation.
If the port is occupied, open the existing Flowfield service or choose another port with flowfield serve --port 8770. Connect the browser and any CLI or MCP clients to that same port.
An agent or model is unavailable
Open Settings → Harnesses and choose Verify installation for the harness you want to use. Check that it is installed and signed in on the machine running Flowfield. Correct executable or configuration-directory overrides if needed. Open the model selector again after correcting the native account or provider configuration. Harness-specific setup is documented for Codex, Claude Code and Pi. For a discovery process that did not stop cleanly, follow agent setup recovery.A task stays in Up next
Read its status on Task Board, then open the task for the details. Check these conditions:- The workspace queue is running.
- The task’s project setup is valid and its agent selections are available.
- Required questions have been answered in Inbox.
- Prerequisite tasks have delivered their results.
- Worker capacity is available.
Setup or validation fails
Open the command output and fix the reported failure. Confirm that the command works from a fresh checkout, that its dependencies are installed by setup, and that required tools are available on the service host. Save corrected commands in Project settings and choose Validate in the relevant tab again. A development server belongs in the Run command; validation commands must finish. See Project setup and checks.A Worker or Reviewer stops
Open the task and inspect its latest activity, question or failure. Answer an outstanding question in Inbox. For failed or stopped execution, follow Retry worker or Retry review after resolving the cause. If Flowfield reports uncertain cleanup, inspect and stop the remaining native work before confirming that it has stopped. The task retains the earlier work and evidence for the next attempt.The Coordinator cannot continue
Use the recovery action in the conversation. If its native session is unavailable, choose Start new session and resend the request with any needed attachments. Saved conversation remains available. If cleanup is uncertain, stop remaining native work on the host, then choose Confirm coordinator stopped. See Stop and continue later.Approved code has not reached my branch
Open the approved result and read its delivery status. Local edits, a changed branch or repository access can block delivery. Resolve the reported repository problem, then retry delivery from the result. If the candidate changes while reconciling with the destination, review and approve the updated result. Review and delivery explains this flow.The browser loses its connection
Check that the Flowfield service is still running. Connection lost retries automatically; choose Try reconnecting after restoring the service. Your open views and drafts remain available. If the connection dropped during a save, inspect the current value before submitting again. Reconnecting… indicates that the update stream is reconnecting; follow any recovery action shown in the affected view.Find local data or restore a backup
Useflowfield storage status to locate the store. Local storage documents the data directory, backups and compatible-version recovery.