pr-cost

Files (32)

• INSTALL.md
• SKILL.md
• pr_cost_from_hook.py · adapters/claude/v1/
• README.md · adapters/codex/
• gh · adapters/codex/bin/
• README.md · adapters/cursor/
• hooks.json · adapters/cursor/
• pr-cost-from-hook.sh · adapters/cursor/
• annotate.md · references/
• billed-validation.md · references/
• diagnosis.md · references/
• payload.md · references/
• claude_session_usage.py · scripts/
• codex_session_usage.py · scripts/
• opencode_session_usage.py · scripts/
• pr_cost_collect.py · scripts/
• pr_cost_doctor.py · scripts/
• emit_valid.json · tests/fixtures/
• hook_claude_pr_create.json · tests/fixtures/
• hook_cursor_pr_create.json · tests/fixtures/
• hook_cursor_pr_view.json · tests/fixtures/
• test_adapters_smoke.py · tests/
• test_annotation_recipe.py · tests/
• test_cache_aware_usd.py · tests/
• test_codex_rate_boundaries.py · tests/
• test_no_hardcoded_paths.py · tests/
• test_opencode_reader.py · tests/
• test_pr_cost_collect.py · tests/
• test_pr_cost_doctor.py · tests/
• test_reader_failure_modes.py · tests/
• test_skill_doc_matches_doctor.py · tests/
• test_usage_key_contract.py · tests/

SKILL.md (first lines)

# pr-cost

Collect session usage after successful PR creation. Prefer the local ledger;
GitHub comments require explicit authorization and `PR_COST_HOOK_LIVE=1`.
Resolve the skill directory from this file's load path and run commands there.

## Route first

- Hook setup or adapter installation: read [INSTALL.md](INSTALL.md).
- Construct or validate a payload, invoke a collector, or select a usage reader:
  read [references/payload.md](references/payload.md).
- Diagnose a harness lane: read [references/diagnosis.md](references/diagnosis.md).
- Add cost to an existing PR: read [references/annotate.md](references/annotate.md).
- Check a rate or cache-pricing claim against billed cost: read
  [references/billed-validation.md](references/billed-validation.md).

Load only the reference needed by the request. Adapters live in
`adapters/{cursor,claude,codex}/`; the collector is `scripts/pr_cost_collect.py`.

## Privacy rules

- Never copy prompts, responses, file contents, or shell output beyond the PR URL.
- Never store API keys, tokens, auth headers, or repo-local secrets.
- Prefer safe metadata only: harness, model, token counts, session identifier,
  bounded timestamps, PR URL, and a short note about confidence.
- Cursor and Codex adapters should treat unavailable data as `null`, not as a
  reason to scrape unrelated local state.

## Environment

- `PR_COST_LEDGER`: optional ledger override. Defaults to
  `~/.local/share/pr-cost/ledger.jsonl`.
- `PR_COST_HOOK_LIVE=1`: enables live `gh pr comment` writes. Unset keeps the
  collector dry and ledger-only.

From cheshirecode/dotfiles, Unlicense.

More from cheshirecode/dotfiles