thedotmack/claude-mem / claude-mem-cursor/skills/agent-cost-report
agent-cost-report
VerifiedBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 100 B |
| CHECKSUMS.txt | markdown | 2.1 KB |
| SKILL.md | skill md | 21.3 KB |
| scripts/acr.py | script | 12.2 KB |
| scripts/acr/__init__.py | script | 105 B |
| scripts/acr/behavior.py | script | 17.5 KB |
| scripts/acr/classify.py | script | 5.5 KB |
| scripts/acr/costs.py | script | 6.3 KB |
| scripts/acr/devices.py | script | 5.4 KB |
| scripts/acr/evidence.py | script | 9.2 KB |
| scripts/acr/labels.py | script | 7.6 KB |
| scripts/acr/measure.py | script | 5.6 KB |
| scripts/acr/mistakes.py | script | 23.1 KB |
| scripts/acr/owner.py | script | 2.9 KB |
| scripts/acr/patterns.py | script | 26.0 KB |
| scripts/acr/period.py | script | 3.8 KB |
| scripts/acr/prices.py | script | 5.0 KB |
| scripts/acr/render.py | script | 52.7 KB |
| scripts/acr/rollup.py | script | 31.7 KB |
| scripts/acr/rules.json | config | 3.5 KB |
| scripts/acr/rules.py | script | 4.5 KB |
| scripts/acr/sample.py | script | 3.6 KB |
| scripts/acr/snapshot.py | script | 2.0 KB |
| scripts/acr/sync.py | script | 3.7 KB |
| scripts/acr/transcripts.py | script | 7.4 KB |
| scripts/acr/wins.py | script | 21.0 KB |
scripts/acr/period.py
View on GitHub"""PT period window (plan Phase 1.2).
Period arguments copied from /workspace/weekly-cost-workflow/parse_transcripts.py:8-14 and
weekly_report.py:11-14 (PT calendar days, end exclusive, ZoneInfo only), with defaults added
per the plan (G3): last 7 full PT days, today excluded. No fixed UTC offsets anywhere.
"""
import datetime as dt
import re
from dataclasses import dataclass
from zoneinfo import ZoneInfo
# copied from /workspace/weekly-cost-workflow/parse_transcripts.py:9 (same at weekly_report.py:11)
PT = ZoneInfo("America/Los_Angeles")
DEFAULT_DAYS = 7
DAY_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
def parse_day(text):
"""'YYYY-MM-DD' (a PT calendar day) -> aware datetime at PT midnight.
copied from parse_transcripts.py:10-11 / weekly_report.py:13-14:
dt.datetime.fromisoformat(x).replace(tzinfo=PT). Strict: anything but a bare calendar day is
rejected (datetime.fromisoformat would silently accept '2026-09-25+00:00' as a naive midnight)."""
if not DAY_RE.match(text or ""):
raise ValueError(f"expected a PT calendar day YYYY-MM-DD, got {text!r}")
return dt.datetime.fromisoformat(text).replace(tzinfo=PT)
def epoch_ms(d):
"""copied from weekly_report.py:13-14: int(<aware dt>.timestamp() * 1000) -> UTC epoch milliseconds."""
return int(d.timestamp() * 1000)
def pt_midnight(day):
"""Aware datetime at 00:00 PT on the given date (never ambiguous: DST switches at 02:00)."""
return dt.datetime.combine(day, dt.time(0), tzinfo=PT)
def now_pt():
return dt.datetime.now(PT)
@dataclass(frozen=True)
class Window:
start: dt.datetime # aware PT midnight; transcripts test s <= t < e
end: dt.datetime # aware PT midnight, exclusive
generated_at: dt.datetime # aware, PT
@property
def start_pt(self):
return self.start.date().isoformat()
@property
def end_exclusive_pt(self):
return self.end.date().isoformat()
@property
def start_epoch_ms(self):
return epoch_ms(self.start)
@property
def end_epoch_ms(self):
return epoch_ms(self.end)
@property
def generated_at_pt(self):
return self.generated_at.strftime("%Y-%m-%d %H:%M PT")
@property
def partial_last_day(self):
# Only an explicit --end later than today's PT date puts a not-yet-finished day in the window.
# The default window ends at the midnight that started today, so this is False by construction.
return self.end.date() > self.generated_at.date()
def block(self):
"""The `window` block every output carries (shape after weekly_report.py:207-238 `window=`)."""
return dict(start_pt=self.start_pt, end_exclusive_pt=self.end_exclusive_pt,
start_epoch_ms=self.start_epoch_ms, end_epoch_ms=self.end_epoch_ms,
generated_at_pt=self.generated_at_pt, partial_last_day=self.partial_last_day)
def resolve_window(start=None, end=None, now=None):
"""Build the PT window from optional --start/--end strings.
Defaults (plan G3): end = the PT midnight that started today (today excluded);
start = end - 7 days. `now` is injectable for tests (an aware datetime)."""
now = (now or now_pt()).astimezone(PT)
e = parse_day(end) if end is not None else pt_midnight(now.date())
s = parse_day(start) if start is not None else pt_midnight(e.date() - dt.timedelta(days=DEFAULT_DAYS))
if not s < e:
raise ValueError(f"--start {s.date()} must be before --end {e.date()} (end is exclusive)")
return Window(s, e, now)
def session_block(session, now=None):
"""`window` block for --session runs: no period filter, so the bounds are null."""
now = (now or now_pt()).astimezone(PT)
return dict(start_pt=None, end_exclusive_pt=None, start_epoch_ms=None, end_epoch_ms=None,
generated_at_pt=now.strftime("%Y-%m-%d %H:%M PT"), partial_last_day=False, session=session)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| backup-setupthedotmack/claude-memSet up, check, or restore local claude-mem database snapshots. Use when the user says "set up backups", "back up my memories", "backup status", or "restore my database". | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |