Logbook — Messages Report

Generate message-count reports from Claude Code session logs. Groups branches under their parent project. Separates human-typed messages from automated user turns (tool results, hooks).

Workflow

Step 1: Run the analysis script

python3 plugins/logbook/scripts/logbook.py messages --out docs/reports

This generates:

• One file per calendar month: YYYYMM-logbook-messages.md
• One file per year: YYYY-logbook-messages.md

To limit to a specific period:

python3 plugins/logbook/scripts/logbook.py messages --year 2026 --month 3 --out docs/reports