codex-usage-tracker MCP server
Commit 14. Okt. 2026Analysiert lokale Codex-Session-Metadaten, um exakte Fakten über Token-Verbrauch, Kosten, Credits und Tool-Muster zu liefern.
Auch bekannt als douglasmonsky/codex-usage-tracker
- Stars
- 196
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 14. Okt. 2026
- Lizenz
- MIT
Was ist codex-usage-tracker MCP?
codex-usage-tracker ist ein MCP server. Analysiert lokale Codex-Session-Metadaten, um exakte Fakten über Token-Verbrauch, Kosten, Credits und Tool-Muster zu liefern.
Zusammenfassung generiert aus dem README des Projekts
Über codex-usage-tracker MCP server
Dieser MCP server ermöglicht es Entwicklern, lokale Codex-Session-Metadaten zu analysieren, um den Token-Verbrauch und die Kosten zu verstehen. Er wandelt lokale Session-Daten in spezifische Fakten zu Zeit, Tools, Credits und Allowances um. Durch die Bereitstellung einer Evidence Console und eines SQLite-Kernels kann ein Agent exakte Nutzungsmuster explorieren und erklären, anstatt sich auf allgemeine Zusammenfassungen zu verlassen.
Nutzer installieren die Python-Runtime via pipx und fügen das Repository dann als Eintrag im Codex-Plugin-Marketplace hinzu. Nach der Konfiguration fungiert der Server als lokaler Tool-Katalog, den ein Agent abfragen kann. Er bietet Einblick in Fakten zu Sessions, Turns, Calls, Tools, Resources, Allowances, Tokens, Credits und Kosten. Dieses Setup ist für Nutzer gedacht, die belastbare Belege darüber benötigen, wie Codex Work Ressourcen verbraucht und ihr Budget beeinflusst.
Was du damit machen kannst
- 1Audit von Tool-NutzungsmusternFordere eine Aufschlüsselung an, welche Tools in spezifischen Turns aufgerufen wurden und wie viele Tokens dabei verbraucht wurden.
- 2Codex-Performance bewertenLass den Agenten die Latenz und Genauigkeit der installierten Codex-Qualifikation analysieren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbardouglasmonsky/codex-usage-tracker is public and reachablegithub.com/douglasmonsky/codex-usage-tracker ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-14github.com/douglasmonsky/codex-usage-tracker ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenCodex Usage Tracker
Codex Usage Tracker is a local usage-data product for answering questions about how Codex work consumes tokens, time, tools, allowance, credits, and cost. It turns local session metadata into exact, bounded facts and stable evidence that an agent can explore and explain.
Current release and next direction
Version 0.28.0 is the current public release. Its six-tool MCP surface, Evidence Console, and SQLite kernel remain supported while the replacement is qualified.
The next product is a clean, agent-first kernel rather than a larger dashboard:
- fast recent-history setup with explicit 24-hour through all-time coverage;
- incremental reuse on every later invocation;
- exact session, turn, call, tool, resource, allowance, token, credit, and cost facts;
- compact named queries and stable evidence selectors;
- agent-owned interpretation instead of server-authored narrative findings;
- installed Codex qualification measured for latency, MCP calls, response bytes, model tokens, accuracy, and usefulness.
The 0.28 code remains a frozen oracle during the rewrite and is removed before the clean replacement release. The new runtime does not migrate or open its database.
Start with the documentation authority, read the
product direction, or follow the
clean-cutover roadmap. Progress is
tracked in the checkbox ledger, with one
complete contract per file under docs/roadmap/tasks/.
Install 0.28.0
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.
Develop
python3 -m venv .venv
.venv/bin/python -m pip install -e ".[dev]"
just v
Use synthetic fixtures only. Do not commit or share real Codex logs, prompts, responses, tool-output bodies, credentials, private paths, or local databases.
codex-usage-tracker MCP Fragen
Wie installiere ich Version 0.28.0?
Installiere die Python-Runtime über pipx, füge das Repository als Codex-Plugin-Marketplace hinzu und installiere das Plugin anschließend.
Sind meine Daten sicher beim Teilen?
Nein, du solltest nur synthetische Fixtures verwenden und niemals echte Codex-Logs, Prompts, Responses oder lokale Datenbanken committen oder teilen.