whatisgithub

What is codex_audit?

emergentknowledgegroup/codex_audit — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A read-only auditing tool that explains why a Codex AI coding task used so much of your usage allowance and suggests better routing, without changing anything itself.

Mindmap

mindmap
  root((codex audit))
    What it does
      Audits token usage
      Recommends routing
      Read only, no changes
    Skills
      Audit
      Orchestrate
      Monitor
    Use cases
      Diagnose usage spikes
      Compare agent configs
      Watch long running tasks
    Audience
      Codex power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Diagnose why a specific Codex task consumed an unusually large amount of your usage allowance.

USE CASE 2

Get codebase-specific model and effort routing recommendations instead of generic advice.

USE CASE 3

Continuously monitor a long-running agentic task and view a live local dashboard.

USE CASE 4

Build a redacted scorecard comparing token usage across different agent configurations over time.

What is it built with?

Python

How does it compare?

emergentknowledgegroup/codex_audit0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Codex Desktop/CLI usage records and manual copying of the skill folder if not installed via Codex itself.

So what is it?

Codex Audit is a set of tools and skills that help you understand why a task run through Codex, an AI coding assistant, used up so much of your five hour or weekly usage allowance. It reads the usage records Codex already keeps and breaks down where the tokens actually went, whether that is the main conversation, helper subagents, the model and effort level chosen, repeated tool output, or cached input being resent over and over. Importantly, the tool only reads and reports. It does not change your model settings, edit your configuration files, modify your codebase, or enforce any routing rules on its own. Every recommendation it makes is left for you to review and apply yourself. The repository ships three separate skills: one that audits and diagnoses usage, one that helps you delegate work to other agents with clear model and scope contracts, and one that continuously monitors a long running task and refreshes a live report. You can install and run it either by asking Codex itself to fetch and install the skill from the repository, or by cloning the repository and copying the relevant folder into your personal Codex skills directory. Once installed, you can ask Codex to audit the current task or a past task by its ID, and it will explain the biggest drivers of usage along with specific suggestions, rather than applying the same generic advice to every kind of task. The project also includes standalone Python scripts you can run directly, without needing any extra third-party packages, to analyze usage, generate a routing recommendation, or build a redacted scorecard comparing different agent configurations over time. Reports are redacted by default, hiding task titles, file paths, and usernames unless you explicitly ask for identifying detail. The README does not state a license for this project.

Copy-paste prompts

Prompt 1
Use audit-codex-token-routing to audit this task's token and subagent usage, recommendations only.
Prompt 2
Use audit-codex-token-routing to audit task <task-id> and explain the biggest usage drivers.
Prompt 3
Use monitor-codex-token-routing to monitor this task in the background and show me a redacted report.
Prompt 4
Calibrate this task now and recommend only the next matched routing experiment, do not change configuration.

Frequently asked questions

What is codex_audit?

A read-only auditing tool that explains why a Codex AI coding task used so much of your usage allowance and suggests better routing, without changing anything itself.

What language is codex_audit written in?

Mainly Python. The stack also includes Python.

How hard is codex_audit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex_audit for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.