Skip to main content
Version: Next

Git & Flow

Push, record PRs, merge, and manage which flow a task follows. The git steps are driven by the /task-git agent.

🤖 Agent-driven

/task-git runs the push/PR/merge commands for you. The flow-control commands (set-flow, set-default-flow) are the ones you're more likely to run yourself.

Git & merge

CommandPurpose
pushPush to the task's branch and update the tracker. Flags: --id, --commit, --message, --branch.
mr-updateRecord the PR/MR URL on the task. Flags: --id, --url.
mergeMerge the branch to the main line. Flag: --id.
doneMark the task complete. Flag: --id.

Flow control

CommandPurpose
advanceAdvance a task along its flow via an agent's transition. Flags: --id, --agent.
set-flowReassign a task to a different flow. Flags: --id, --flow.
set-default-flowMake a flow the default for new tasks. Flag: --flow.

Example

insight-flow push --id N42 --message "feat: add auth" --branch feat/N42-auth
insight-flow mr-update --id N42 --url https://github.com/owner/repo/pull/123
insight-flow merge --id N42
insight-flow done --id N42

See Transitions & agents for how these commands map to flow handovers.