Usage Statistics

Track tool usage across sessions with rich terminal visualizations. Pie charts, braille progress bars, and ASCII art headers make monitoring usage patterns intuitive and beautiful.

Why Track Usage?

• Cost Awareness - See which AI providers consume most of your budget
• Pattern Recognition - Identify your most-used tools and workflows
• Optimization - Find opportunities to use cheaper models for simple tasks
• Debugging - Understand what happened during complex multi-model sessions

Quick Start

View Statistics

Returns a rich terminal visualization with:

• BigText ASCII Header - "TACHIBOT" in block font with cristal gradient (cyan→green)
• Pie Chart - Tool usage distribution with colored segments
• Braille Progress Bars - High-resolution usage bars using Unicode braille (⣿⣧⡇⡀)
• Donut Chart - Cost distribution with total in center
• Summary Table - Total calls, tokens, cost, and date range

Reset Statistics

Clears all statistics for the current repository. Useful when starting a new project phase.

Parameters

Scope: Per-Repo vs Global

Statistics are tracked per repository by default. This helps you understand usage patterns for specific projects.

Current Repository

All Repositories

Output Formats

Table Format (Default)

Human-readable ASCII table with bar charts. Best for quick overview in Claude/Cursor.

JSON Format

Machine-readable JSON for integration with other tools or dashboards:

Visual Features

Usage stats now includes rich terminal visualizations:

• BigText ASCII Headers - Gradient-colored ASCII art titles using block font
• Pie Charts - Visual distribution of tool usage with percentage breakdown
• Braille Progress Bars - High-resolution Unicode braille bars (⣿⣀) for usage visualization
• Donut Charts - Cost distribution visualization with center total
• Gradient Dividers - Colored separators using gradient presets (cristal, rainbow, mind)

What Gets Tracked

• Tool Calls - Number of times each tool was invoked
• Tokens - Approximate token usage per tool
• Cost - Estimated cost based on provider pricing
• Workflows - Tool usage from workflow executions
• Models - Which AI models were used per tool

Configuration

Control usage tracking behavior with environment variables:

Best Practices

• Check weekly - Review stats to understand your usage patterns
• Reset per sprint - Clear stats at the start of each project phase
• Compare repos - Use scope: "all" to see which projects consume most
• Export JSON - Save stats for billing reconciliation or team reviews