Board, Code Browser & Stats

ait board

Open the kanban-style TUI board for visual task management.

ait board

Launches a Python-based terminal UI (built with Textual) that displays tasks in a kanban-style column layout. All arguments are forwarded to the Python board application.

For full usage documentation — including tutorials, keyboard shortcuts, how-to guides, and configuration — see the Kanban Board documentation.

Requirements:

• Python venv at ~/.aitask/venv/ with packages: textual, pyyaml, linkify-it-py
• Falls back to system python3 if venv not found (warns about missing packages)
• Checks terminal capabilities and warns on legacy terminals (e.g., WSL default console)

ait codebrowser

Open the code browser TUI for file exploration with task annotations.

ait codebrowser

Launches a Python-based terminal UI (built with Textual) that provides a file tree, syntax-highlighted code viewer, and annotation gutter showing which aitasks contributed to each section of code. All arguments are forwarded to the Python codebrowser application.

For full usage documentation — including tutorials, keyboard shortcuts, how-to guides, and annotation details — see the Code Browser documentation.

Requirements:

• Python venv at ~/.aitask/venv/ with packages: textual, pyyaml
• Falls back to system python3 if venv not found (warns about missing packages)
• Checks terminal capabilities and warns on legacy terminals (e.g., WSL default console)

ait stats

Display task completion statistics and trends.

ait stats                  # Basic stats (last 7 days)
ait stats -d 14            # Extended daily view
ait stats -v               # Verbose with task IDs
ait stats --csv            # Export to CSV
ait stats -w sun           # Week starts on Sunday

Statistics provided:

1. Summary — Total completions, 7-day and 30-day counts
2. Daily breakdown — Completions per day (with task IDs in verbose mode)
3. Day of week averages — This week counts + 30-day and all-time averages per weekday
4. Label weekly trends — Per-label completions for last 4 weeks
5. Label day-of-week — Per-label averages by day of week (last 30 days)
6. Task type trends — Parent/child and issue type (feature/bug/refactor) weekly trends
7. Label + type trends — Issue types by label, weekly for last 4 weeks
8. Code agent trends — Weekly completion split by code agent for last 4 weeks
9. LLM model trends — Weekly completion split by normalized LLM model for last 4 weeks

Data sources: Scans archived parent tasks (aitasks/archived/t*_*.md), archived child tasks (aitasks/archived/t*/), and compressed archives (numbered _bN/oldM.tar.gz bundles). Uses completed_at field, falling back to updated_at for tasks with status: Done.

CSV export format: date, day_of_week, week_offset, task_id, labels, issue_type, task_type, implemented_with, codeagent, llm_model. Open in LibreOffice Calc for custom charts and pivot tables.

Interactive charts:

For interactive terminal charts (daily completions, weekday averages, top labels, issue types, code agents, LLM models), use ait stats-tui. The TUI is launched directly or switched into from any other aitasks TUI (j in the TUI switcher). It uses the optional plotext package, installed via ait setup when prompted.

Next: Explain Utilities