MKTRUE-AUDIT(1)mktrue 1.3.1MKTRUE-AUDIT(1)

mktrue audit

NAME

mktrue audit — measure this repository’s Claude Code sessions in one local report

SYNOPSIS

mktrue audit [--out <file>] [--json] [--since <date>] [--until <date>]

DESCRIPTION

audit reads this repository’s local Claude Code transcripts and writes one HTML report. It sends nothing. Run it from anywhere inside a git repository.

It reads the sessions of the repository and of its worktrees, and drops any record from another project before counting.

It reports calls by context size, the fixed reading per turn, documents read more than once, one row per subagent, resumed agents and gate runs, per slice.

The report goes under the repository’s git directory, or to --out. --json prints it to stdout and writes no file. It is a read model, not a gate: it never exits with findings.

--since and --until keep the records from one local midnight to another, each day written YYYY-MM-DD. Merged pull requests are counted in the same window.

OPTIONS

--out <file>
Write the report to this file.
--json
Print the report to stdout, and write no file.
--since <date>
Keep records from this day’s local midnight, written YYYY-MM-DD.
--until <date>
Keep records before this day’s local midnight, written YYYY-MM-DD. Merged pull requests are counted in the same window.
--help
Print this screen: the command’s usage, its flags and its exit codes.

EXIT STATUS

0true: a report was produced.
2usage: a bad argument, --out with --json, a date that is not YYYY-MM-DD, --since not before --until, or not inside a git repository.
3environment: this repository has no transcripts to read, or the report could not be written.

EXAMPLES

In a fresh git repository, before any Claude Code session.

exit 3
mktrue auditmktrue: ✗ environment · no Claude Code transcripts for this repository  why   audit reads only the project dirs Claude Code wrote for this repository  fix   run Claude Code in this repository first, or set CLAUDE_CONFIG_DIR  exit  3

Real output from mktrue 1.3.1, captured with NO_COLOR set.

SEE ALSO