mktrue check
NAME
mktrue check — report whether this repository is still true to the method
SYNOPSIS
mktrue check [--siblings [--json]]
DESCRIPTION
check is read-only, and it sends nothing. It reports what no longer holds: a document over its budget, a document over the read budget budgets.reads gives it, a bench that is not intact, a role without a tier, a document path that does not resolve, no gates listed, deny rules missing from the settings file, and kit-owned files edited without a pin. Each finding says why it matters and how to fix it.
Every repository new makes runs it in CI on every push.
--siblings also reads each repository answers.siblings names, at its base branch, through local git only: no fetch, no checkout, no write. The usual checks run first, and the exit is the worse of the two. --json prints that report alone.
OPTIONS
--siblings- Also compare each repository answers.siblings names with this one, through local git.
--json- With
--siblings, print the report as JSON, and nothing else. --target <name>- With
--siblings, the agent target to compare for. The default is claude-code. --bench <dir>- The kit to check against. The default is the installed kit.
--help- Print this screen: the command’s usage, its flags and its exit codes.
EXIT STATUS
| 0 | true: nothing has drifted. |
| 1 | findings: at least one, each printed with why and fix. With --siblings, also any divergence. |
| 2 | usage: .mktrue.json does not parse. With --siblings, there is no .mktrue.json or no bench to compare with. |
| 3 | environment: with --siblings, a listed sibling could not be read. |
EXAMPLES
A repository just made by new.
mktrue checkmktrue: check · 7 of 7 ✓mktrue: budgets · rules 8 620 / 10 000 · state 333 / 2 500mktrue: budgets · decisions 0 · largest 0 / 12 000mktrue: bench · 35 entries · 27 slotsmktrue: tiers · 6 roles · 6 tieredmktrue: paths · 6 of 6 resolvemktrue: gates · 4 listedmktrue: settings · 31 of 31 deny rules · 2 of 2 hooksmktrue: drift · 17 owned · 0 edited · 0 pinnedmktrue: true · exit 0
The same repository after a kit-owned file was edited by hand.
mktrue checkmktrue: check · 6 of 7 ✗mktrue: budgets · rules 8 620 / 10 000 · state 333 / 2 500mktrue: budgets · decisions 0 · largest 0 / 12 000mktrue: bench · 35 entries · 27 slotsmktrue: tiers · 6 roles · 6 tieredmktrue: paths · 6 of 6 resolvemktrue: gates · 4 listedmktrue: settings · 31 of 31 deny rules · 2 of 2 hooksmktrue: drift · 17 owned · 1 edited · 0 pinnedmktrue: ✗ drift · .claude/agents/README.md was edited after the kit wrote it why the next sync sees it as yours and will stop updating it, so the method quietly stops improving here fix pin it in .mktrue.json to keep your version, or revert it and put the change in a repository-owned filemktrue: 1 finding · exit 1
Real output from mktrue 1.3.1, captured with NO_COLOR set.