Skip to content
Back to search

codex-usage-tracker

Local-first MCP tools and dashboard for investigating Codex token usage, credits, costs, caching, and thread patterns.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/douglasmonsky-codex-usage-tracker/badge.svg)](/listings/douglasmonsky-codex-usage-tracker)

HTML

<a href="/listings/douglasmonsky-codex-usage-tracker"><img src="/api/listings/douglasmonsky-codex-usage-tracker/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the Python runtime into an isolated executable environment, then add the matching tagged repository as a Codex plugin marketplace:

pipx install "codex-usage-tracking==0.28.0"
codex plugin marketplace add douglasmonsky/codex-usage-tracker --ref v0.28.0
codex plugin add codex-usage-tracker@codex-usage-tracker

The plugin launches the `codex-usage-tracker` executable from the pipx environment. Start a fresh Codex task after installation so it discovers the new plugin tool catalog.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 64 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Codex Usage Tracker
  2. [![PyPI](https://img.shields.io/pypi/v/codex-usage-tracking)](https://pypi.org/project/codex-usage-tracking/)
  3. [![Python](https://img.shields.io/pypi/pyversions/codex-usage-tracking)](https://pypi.org/project/codex-usage-tracking/)
  4. [![CI](https://github.com/douglasmonsky/codex-usage-tracker/actions/workflows/ci.yml/badge.svg)](https://github.com/douglasmonsky/codex-usage-tracker/actions/workflows/ci.yml)
  5. [![License](https://img.shields.io/github/license/douglasmonsky/codex-usage-tracker)](LICENSE)
  6. Codex Usage Tracker is a local usage-data product for answering questions about
  7. how Codex work consumes tokens, time, tools, allowance, credits, and cost. It
  8. turns local session metadata into exact, bounded facts and stable evidence that
  9. an agent can explore and explain.
  10. ## Current release and next direction
  11. Version 0.28.0 is the current public release. Its six-tool MCP surface,
  12. Evidence Console, and SQLite kernel remain supported while the replacement is
  13. qualified.
  14. The next product is a clean, agent-first kernel rather than a larger dashboard:
  15. - fast recent-history setup with explicit 24-hour through all-time coverage;
  16. - incremental reuse on every later invocation;
  17. - exact session, turn, call, tool, resource, allowance, token, credit, and cost
  18. facts;
  19. - compact named queries and stable evidence selectors;
  20. - agent-owned interpretation instead of server-authored narrative findings;
  21. - installed Codex qualification measured for latency, MCP calls, response
  22. bytes, model tokens, accuracy, and usefulness.
  23. The 0.28 code remains a frozen oracle during the rewrite and is removed before
  24. the clean replacement release. The new runtime does not migrate or open its
  25. database.
  26. Start with the [documentation authority](docs/INDEX.md), read the
  27. [product direction](docs/decisions/PRODUCT_DIRECTION.md), or follow the
  28. [clean-cutover roadmap](docs/roadmap/AGENT_FIRST_CLEAN_CUTOVER.md). Progress is
  29. tracked in the [checkbox ledger](docs/roadmap/TASK_PACKETS.md), with one
  30. complete contract per file under [`docs/roadmap/tasks/`](docs/roadmap/tasks/).
  31. ## Install 0.28.0
  32. Install the Python runtime into an isolated executable environment, then add
  33. the matching tagged repository as a Codex plugin marketplace:
  34. ```bash
  35. pipx install "codex-usage-tracking==0.28.0"
  36. codex plugin marketplace add douglasmonsky/codex-usage-tracker --ref v0.28.0
  37. codex plugin add codex-usage-tracker@codex-usage-tracker
  38. ```
  39. The plugin launches the `codex-usage-tracker` executable from the pipx
  40. environment. Start a fresh Codex task after installation so it discovers the
  41. new plugin tool catalog.
  42. ## Develop
  43. ```bash
  44. python3 -m venv .venv
  45. .venv/bin/python -m pip install -e ".[dev]"
  46. just v
  47. ```
  48. Use synthetic fixtures only. Do not commit or share real Codex logs, prompts,
  49. responses, tool-output bodies, credentials, private paths, or local databases.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.