CLI reference

The insight-flow binary owns task state (JSON under insightFlow/workTasks/) and serves the dashboard. Run insight-flow help for the authoritative list of commands.

insight-flow <command> [flags]
# e.g.
insight-flow create --title "Add auth" --type feat --priority high --tags auth

Most of these are agent-driven

insight-flow is built to be run by the agents, not typed by hand all day. Commands that create tasks and move them through the lifecycle — create, current, next, list, stats, implement-start, review-end, and the rest — are normally called for you by the slash-command agents as they work. You can run any of them directly (handy for inspecting state or scripting), but you don't need to for everyday use.

In the group pages below, look for the 🤖 Agent-driven note: it marks commands you'd typically let an agent run. Commands without it (project setup, dashboards, migrations) are the ones you're more likely to run yourself.

Command groups

Commands are grouped by what they do — each group has its own page:

Group	What it covers
Setup & Dashboard	init, ui, master, help, version, bulk-*
Tasks & Query	create, list, current, show, stats, next*, status, rename
Implementation	implement-start, implement-end
Review & Fixes	review-start/-end, fix-start/-end
Change requests	change-request, change-start/-end, next-change
Git & Flow	push, mr-update, merge, done, advance, set-flow, set-default-flow
Incidents	incident-create/-status/-resolve/-list
Config & Migration	migrate, migrate-reviews, migrate-layout, prompt-build
Events & Hooks	log-event, log-activity, notify, install-*, migrate-hooks, hook

Stay accurate

This reference is hand-curated from the command definitions in packages/taskflow/src/cli/. A future task will auto-generate it so it can never drift — for now, insight-flow help is the ground truth.