KQ-791 · PLAN/TREE
Plan Tree
A tree of steps that unfolds while an agent plans. Rows arrive from a nudge on the enter ease and a branch's group grows to a measured height on glide as sub-steps are planned; a running node breathes, a done node fills and ticks on flick, a failed one crosses in danger. Bumping a branch's plan revision folds it on the exit ease and regrows it on glide with a cascade. Arrow keys walk the tree, Right opens or enters a branch, Left folds or leaves it, Enter and Space toggle.
KQ-791 · PLAN/TREE
Release note0 / 0
No plan yet.
Idle · press plan
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/plan-tree
Props
- nodes
- PlanNode[]
- default —
- The plan, root steps in order; append to unfold it. A node with a children array is a branch, and its plan revision re-plans it when bumped.
- expanded / defaultExpanded
- string[]
- default —
- Controlled or initial open branches; omitted, every branch starts open.
- onExpandedChange
- (ids: string[]) => void
- default —
- Fires from a row press or an arrow key with every open branch id.
- label
- string
- default —
- Names the tree.
| Prop | Type | Default | Description |
|---|---|---|---|
| nodes | PlanNode[] | — | The plan, root steps in order; append to unfold it. A node with a children array is a branch, and its plan revision re-plans it when bumped. |
| expanded / defaultExpanded | string[] | — | Controlled or initial open branches; omitted, every branch starts open. |
| onExpandedChange | (ids: string[]) => void | — | Fires from a row press or an arrow key with every open branch id. |
| label | string | — | Names the tree. |