monthly-report

Generating a monthly usage report requires passing a target month in YYYY-MM format to the script. It aggregates Claude Code token data, computes the business share ratio, and outputs the report to stdout or an optional file directory.

Business classification works by matching project paths against a configured folders list. The script categorizes Claude Code usage as business or non-business based on this list, then computes the corresponding share ratio for the monthly report.

Yes, you can export your monthly token usage report to a CSV file. The script supports TXT and CSV file export when the REPORT_OUTPUT_DIR environment variable is configured, alongside default stdout display.

No external dependencies are required to run the monthly data aggregation script. The Skill operates independently with its built-in scripts component to parse data, sum tokens, and compute the business share ratio without third-party packages.

Automating monthly reporting for Claude Code projects is best handled by a dedicated aggregation script. It parses token usage, applies business classification from a configured folders list, and generates a report with optional TXT or CSV file export.