session-cost-forensics
Analyze local Codex, Pi, and Claude Code session logs for cost, token waste, cache misses, retries, duplicate sessions, and orchestration inefficiency. Privacy: reads local session stores (~/.codex, ~/.pi/agent/sessions, ~/.claude/projects) read-only and makes no network requests.
Requirements
- Node.js >= 22.19
Install
Pi
# pinned
pi install npm:@ayagmar/session-cost-forensics@0.1.0
# unpinned
pi install npm:@ayagmar/session-cost-forensics
# remove
pi remove npm:@ayagmar/session-cost-forensics
skills CLI
npx skills add ayagmar/agents-skills --skill session-cost-forensics --agent pi
Other agent ids: claude-code, codex, cursor.
Claude Code
claude plugin marketplace add ayagmar/agents-skills
claude plugin install session-cost-forensics@ayagmar-skills
Codex
codex plugin marketplace add ayagmar/agents-skills
codex plugin add session-cost-forensics@ayagmar-skills
Usage
Prompt example: "Why did my agent sessions get so expensive this week? Break down token and cache usage." The agent runs the bundled script itself.
Run from the installed skill directory:
node scripts/session_cost_report.mjs --provider all --since 2026-09-01 --until 2026-09-28 --top 10
See SKILL.md for the full option list.