Skip to main content
Version: Next

The dashboard

The dashboard is insight-flow's live, visual workbench. It is a React + Vite single-page app served by the CLI's HTTP server, and it renders the same task store the agents and CLI read and write — a Kanban board, per-task detail, the agent / module registry, your flow editor, and a real-time activity feed of what Claude is doing right now.

Nothing on the dashboard is a separate database. Every panel reads the JSON under your project's task store, so what you see is always what the CLI sees.

Launching it

From any insight-flow project:

insight-flow ui

This starts the dashboard at http://localhost:6006 and auto-starts the master hub on port 6100 — the single-origin, installable switcher that manages all your projects at once. Open the printed URL in your browser.

Managing several projects?

Open the master hub at http://localhost:6100/overview. It reverse-proxies each project's dashboard at /project/<id>/, starts stopped projects, creates new ones from the browser, and can be installed as a PWA (including on your phone). This single-project dashboard is one project's view; the hub is the home base across projects.

If you are working inside this repository's sandbox, the playground wires the same thing up:

pnpm play # → http://localhost:6006
Live by default

The dashboard subscribes to a server-sent-events (SSE) stream, so it never needs a manual refresh. Create a task from the CLI, run an agent, or edit a flow in another tab, and the open dashboard updates itself.

A tour of the views

The dashboard is a handful of routes, all reachable from the top navigation:

ViewWhat it is for
Kanban boardThe landing page — your tasks laid out in flow-status columns, with shard navigation, aggregate stats, and a notification settings popover.
Task detailEverything about one task: metadata, status history, reviews, incidents, and its position in the lifecycle flow.
Agents browserEach agent's composed modules and the artifacts it installs.
Modules browserThe full module registry and each module's composition map.
Flow / project editorYour named flows — their agents, flow graph, statuses, entry points, and install list.
Activity feedLive Claude status and a timeline of events, streamed over SSE.

Head to the views guide for a section on each, or read the concepts behind the agent / module / flow views first.

New to insight-flow?

If you have not run a task yet, start with Getting started — then come back and watch the board light up.