ccflare-insights

Analyze better-ccflare proxy usage, token spend, cache behavior, and request anomalies over Tailscale.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/wesbragagt/nixos-config --skill ccflare-insights-wesbragagt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ccflare-insights
Source: https://github.com/wesbragagt/nixos-config/tree/main/home/skills/ccflare-insights
Command: npx skills add https://github.com/wesbragagt/nixos-config --skill ccflare-insights-wesbragagt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Understanding how AI agents consume tokens, hit caches, and trigger anomalies across a shared better-ccflare proxy is difficult without a structured, read-only reporting workflow that respects privacy and data limits. ## Core Features & Use Cases - Usage and cost analysis: Queries the remote better-ccflare Insights API over Tailscale to report per-agent request counts, token breakdowns, cost, latency, and failover metrics for a chosen time range. - Cache and anomaly reporting: Surfaces global cache hit rates, savings when pricing is known, and aggregate anomaly detector findings with redacted identifiers. - Privacy-safe advisory output: Produces a fixed-section advisory report with coverage caveats, never printing prompts, request IDs, or raw JSON, and never modifying proxy configuration. - Use Case: Ask for a 7-day ccflare usage review to see which agents drive token spend, whether cache reuse is effective, and whether any runaway loops need attention. ## Quick Start Ask the assistant to run a ccflare-insights report for the last 7 days summarizing agent usage, token cost, and cache behavior.

Frequently Asked Questions about ccflare-insights

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze ccflare proxy usage and token spend?

Run the ccflare-insights workflow with a time range such as 7d or 30d. It queries the remote better-ccflare Insights API over Tailscale and reports per-agent request counts, token breakdowns, cost, and latency in a fixed-section advisory report.

What time ranges does ccflare insights reporting support?

Supported ranges are 1h, 6h, 24h, 7d, and 30d, with 7d as the default. Any other input is rejected with the accepted syntax, and each token may appear at most once.

Does the ccflare insights report expose prompts or request payloads?

No. The report never prints prompts, response bodies, request IDs, session IDs, account identifiers, or raw JSON. Payload-derived context analysis only runs when the explicit context opt-in token is included, and even then only aggregate totals are reported.

Can ccflare-insights change proxy settings or reset stats?

No. It is strictly read-only and advisory. It never calls POST, PATCH, DELETE, /api/stats/reset, or any endpoint outside the documented GET list, and it does not modify proxy settings, agents, or accounts.

Why does the ccflare report say rankings or comparisons are unavailable?

Rankings are unavailable when the 1000-record request sample is incomplete for the window, and comparisons are unavailable when either group has fewer than 10 in-range requests. These coverage rules prevent misleading conclusions from partial data.