cacheforge-stats_skill

Overview

This skill provides a terminal dashboard for CacheForge showing usage, savings, and cache performance metrics. It surfaces token reduction rates, cost savings, and detailed breakdowns by model, provider, or key. The tool is designed for quick operational insights and billing reconciliation from the command line.

How this skill works

The skill queries CacheForge account endpoints to collect billing, account info, usage, and breakdown data. It renders a compact terminal dashboard with charts and summaries, and offers focused commands for usage windows, breakdowns, and savings views. Configuration is done via environment variables for the API base URL and API key.

When to use it

• When you need a quick terminal view of CacheForge usage and cost savings
• When monitoring token reduction rates and cache hit performance
• When reconciling billing or exploring cost breakdowns by model/provider/key
• When you want a compact chart-driven summary without a web UI
• When automating periodic checks in a CI or ops script

Best practices

• Set CACHEFORGE_API_KEY in your environment to avoid exposing secrets in command history
• Use the --window flag for focused short-term analysis (e.g., 7d) and longer windows for trend spotting
• Run breakdown commands by model or provider to identify high-cost or low-efficiency models
• Schedule regular runs in cron or CI to capture trends and export summaries for billing reports
• Combine savings and usage views to validate cache tuning changes

Example use cases

• Daily ops check: run the full dashboard to verify cache health and recent savings
• Cost analysis: use the breakdown command to find which models drive the highest spend
• Optimization validation: compare savings view before and after cache rule changes
• Billing reconciliation: pull usage and billing endpoints to match invoices
• Automation: integrate usage output into monitoring or alerting pipelines