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
TACHIBOT
(ASCII art header with cristal gradient in terminal)
▊ USAGE STATS — tachibot-mcp
──────────────────────────────────
▊ Tool Usage Distribution
██████████████████
█ gemini_brainstorm (13.5%)
█ grok_search (11.8%)
█ perplexity_ask (10.6%)
█ nextThought (7.6%)
█ Other (45.1%)
ToolUsageCallsCost
gemini_brainstorm⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿55$0.44
grok_search⣿⣿⣿⣿⣿⣿⣿⣿⡀48$0.10
Total: 406 calls | ~556k tokens | $3.54
Reset Statistics
Clears all statistics for the current repository. Useful when starting a new project phase.
Parameters
| Parameter | Type | Default | Description |
|---|
| action | "view" | "reset" | required | View stats or reset them |
| scope | "current" | "all" | "current" | Current repo or all repos |
| format | "table" | "json" | "table" | Output format |
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
Note: Statistics persist across sessions in ~/.tachibot-usage.json. Core tools (think, nextThought) are free and don't add to cost.
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