BTR Stats

BTR Stats

⚠️ CRITICAL: BTR ≠ ByteRover

This skill uses btr (local context tree), NOT brv (ByteRover CLI).

PREFER MCP tools when available:

• mcp__btr__query_context - For searching
• mcp__btr__list_contexts - For browsing
• mcp__btr__get_stats - For statistics

Only use Bash btr commands if MCP tools are unavailable.

Show analytics and ROI metrics for your context library.

Quick Start

btr stats [--format json|table]

Metrics Displayed

• Total Contexts: Number of stored knowledge items
• Contexts by Domain: Distribution across domains
• Most Retrieved: Top 10 most frequently accessed contexts
• Total Retrievals: How many times contexts have been used
• Estimated Time Saved: Based on usage count x avg retrieval time (15 min)

Example Output

BTR Statistics
====================

Total Contexts:     42
Total Domains:      8
Total Retrievals:   156

Estimated Time Saved: 39 hours

Top Domains:
  auth:       12 contexts (45 retrievals)
  api:        10 contexts (38 retrievals)
  database:    8 contexts (29 retrievals)

Most Retrieved:
  1. auth/​jwt-validation (23 retrievals)
  2. api/​rate-limiting (18 retrievals)
  3. database/​connection-pooling (15 retrievals)

Command Options

Basic Statistics

btr stats

Shows overall statistics in a human-readable table format.

JSON Output

btr stats --format json

Outputs structured JSON for programmatic use or dashboards.

Time Period Filter

btr stats --period 30d   # Last 30 days
btr stats --period 7d    # Last 7 days
btr stats --period 1y    # Last year

Domain-Specific Stats

btr stats --domain auth

Shows detailed statistics for a specific domain.

Understanding ROI Metrics

Time Saved Calculation

The time saved estimate is calculated as:

Time Saved = Total Retrievals x Average Time to Find Info Manually

Where:
- Average Time to Find Info Manually = 15 minutes (default)
- This accounts for searching docs, Stack Overflow, or reimplementing

Value Proposition

*Based on $100/​hour developer cost

Advanced ROI Calculation

For detailed ROI analysis with customizable parameters, run the Python script:

python .claude/​skills/​btr-stats/​scripts/​calculate-roi.py

Options:

• --hourly-rate: Developer hourly rate (default: $100)
• --avg-time: Average manual search time in minutes (default: 15)
• --format: Output format (json, csv, markdown)

Tracking Tips

1. Consistent Retrieval: Use btr query to ensure retrievals are tracked

2. Review Regularly: Check stats monthly to identify valuable patterns

3. Prune Unused: Remove contexts with zero retrievals after 90 days

4. Enhance Popular: Add more detail to frequently-accessed contexts

Integration with Dashboards

Export stats for external dashboards:

# Daily export to JSON
btr stats --format json > /​path/​to/​metrics/​btr-$(date +%Y%m%d).json

# Append to CSV log
btr stats --format csv >> /​path/​to/​metrics/​btr-stats.csv