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 --plot           # Render interactive terminal charts (requires optional plotext)
ait stats -d 30 --plot     # Charts over a longer date range
ait stats --csv out.csv --plot  # Export CSV and render charts in the same run
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

Data sources: Scans archived parent tasks (aitasks/archived/t*_*.md), archived child tasks (aitasks/archived/t*/), and compressed archives (old.tar.gz). 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. Open in LibreOffice Calc for custom charts and pivot tables.

Plot mode (--plot):

• Uses optional plotext to render interactive terminal charts.
• If plotext is not installed, ait stats still runs and prints the normal text report, then shows a warning and skips chart rendering (no crash).
• Enable it via ait setup in the Python venv step when prompted: Install plotext for 'ait stats --plot'? [y/N].