This walks you from a running dashboard to your first project and first task. If FlowBoard isn't installed yet, do the Quick Start first.
Go to http://localhost:18790. The board opens on the project overview (or an empty state if you have no projects yet).
If a Finish setup or Migration required chip appears in the header, click it and follow the modal — it wires FlowBoard into your agent workspaces. Every change writes a .bak-<timestamp> backup first, so it's safe to apply. The chip disappears once setup is done.
A project is a workspace with its own goal, tasks, specs, and context. Two ways to create one:
- Tell your agent: “FlowBoard: create project my-app”. The agent calls the API, scaffolds the project files (
PROJECT.md,SESSIONS.md,DECISIONS.md,specs/,context/), and registers it. - From the dashboard: use the project switcher in the sidebar.
Activating a project is what loads its context for an agent — see Manage projects.
Tasks move through five columns: backlog → open → in-progress → review → done.
- Add a task (the quick-add in the board, or your agent creates it via the API).
- An agent claims it (taking a lease), moves it to in-progress, and writes checkpoints as it works.
- When the work is ready, it goes to review — you approve it to done. Agents don't self-approve.
You can drag cards between columns, reorder within a column, and open any card for its description, spec, checkpoints, and activity.
Open the Canvas to think visually: drop sticky notes, connect them into clusters, then select notes and click Create Task. The Specify stepper turns them into a task (or a parent task with subtasks and specs) right in the browser.
The overview is a widget grid you can edit: enter edit mode, drag widgets by their title bar, resize from the edges, add widgets from the picker, or apply a preset. Agents can shape the same grid via the API.
- Search and filter tasks
- Use FlowBoard on a phone or in Telegram
- Manage projects — including the difference between archiving and deleting