custo-hoje

Lê: JSONLs descobertos via CLAUDE_CONFIG_DIR (multi-account) → XDG_CONFIG_HOME/claude → ~/.claude (POSIX) / %APPDATA%/claude (Windows), filtrando projects/<slug>/*.jsonl.

Cria/Atualiza: nada por default. Com --persist, grava snapshot em .planning/costs/<ts>-cost-today.json (gitignored).

Após: o user vê tabela compacta total_usd + breakdown by_model + flags de qualidade (unknown_models, pricing_staleness_days).

Disambiguation: este comando é sobre USD/tokens reais gastos — NÃO sobre error budget de SLO (use /burn-rate-status para isso). Ver skill cost-tracking para detalhes.

Flags:

• --tz <IANA> — timezone do "dia". Default: UTC (paridade ccusage). Exemplo: --tz America/Sao_Paulo.
• --refresh-pricing — opt-in fallback models.dev para modelos não cobertos pelo snapshot embedded. Side-effect: HTTP fetch + cache em ~/.kit-mcp/pricing-cache.json (TTL 24h). NÃO use por padrão.
• --persist — grava snapshot do output em .planning/costs/.

Cross-reference: comando ↔ MCP tool. A SSOT do shape de output e do pipeline parser→dedup→price é a skill cost-tracking + os módulos em src/core/cost/. Este comando é apenas o wrapper PT-BR de invocação no Claude Code.

1. Parsear argumentos

TZ=$(echo "$ARGUMENTS" | grep -oE -- '--tz [^ ]+' | awk '{print $2}')
REFRESH=$(echo "$ARGUMENTS" | grep -oE -- '--refresh-pricing' | head -1)
PERSIST=$(echo "$ARGUMENTS" | grep -oE -- '--persist' | head -1)

2. Invocar MCP tool cost-today

Chame o tool cost-today com:

{
  "tz": "<TZ ou omitir para UTC>",
  "refresh_pricing": <true se --refresh-pricing, senão omitir>,
  "persist": <true se --persist, senão omitir>
}