Task pile¶

Ideas arrive while your hands are busy. Say "note: the login flow needs retry logic" (system key) and it lands as a checklist item in .vupai/tasks.md at the current repo's root - a plain markdown file you can edit by hand, that agents can read too. vupai only ever appends, annotates, and checks off items; it never reorders or rewrites yours.

Everything you can do with the pile, by voice and from the CLI:

• Capture by voice: "note …", "add a task …". A y/n popup previews the transcribed text before it's appended (confirm_notes, on by default, independent of confirm_destructive); confirm and vupai answers "noted".
• Hear it: "read tasks" (or just "tasks") speaks the open items.
• Watch it live: "open tasks" (or vupai tasks --pane) splits a read-only pane, like the supervision board, that re-polls the pile every couple of seconds - handy for keeping the list in view while you work.
• Work it from the CLI: vupai tasks lists open items numbered, vupai tasks add <text> appends, vupai tasks done <n> checks one off, vupai tasks --done shows finished items too.
• Triage the pile: say "triage" (or "groom the tasks"; CLI: vupai tasks triage [--yes]) and vupai sends every open item through the same swappable summarizer command as the board (board_summarizer_cmd) to grade importance and effort. It's advisory only: after one y/n popup it writes the ratings as plain, hand-editable [p1, S] text on the task lines, which vupai tasks and the tasks pane then show. Conflicts between open items are spoken aloud, never written to the file. The triage_timeout_s config key (default 30) bounds how long the summarizer gets.
• Fix it by hand: say "edit tasks" (or vupai tasks edit) to open the pile in $VISUAL/$EDITOR (vim fallback) - by voice it opens in a tmux split off the focused pane, labeled editor on the pane border (never an agent callsign). This is the intended way to delete, reword, or reorder items, e.g. after a mishearing slipped past the note popup.

Like the activity ledger, the pile lives in the auto-gitignored .vupai/ directory: local by default, yours to commit or sync if you choose.