MKTRUE-SYNC(1)mktrue 1.3.1MKTRUE-SYNC(1)
mktrue sync
NAME
mktrue sync — bring the method up to date
SYNOPSIS
mktrue sync [--write] [--adopt] [--restore]
DESCRIPTION
sync brings the files the kit owns up to date with this kit, one file at a time, against the hash recorded when each was written:
- unchanged here, changed in the kit: updated.
- changed here, unchanged in the kit: kept.
- changed in both: a conflict. When the kit still has a version of the file, it is written beside it as a .mktrue-next copy.
- pinned in .mktrue.json: skipped, and reported.
- deleted here: reported, and put back only with
--restore. - retired by the kit, a file it no longer renders: deleted with
--writewhen it is unchanged here. Changed here, it is a conflict with no .mktrue-next copy, because the kit has no version left to write.
It is a dry run unless --write. It never touches what the repository owns: its own rules sections, state, decisions, plans, logs and source code. The settings file is written only when there is none.
--adopt takes the kit’s version of files that were never under management. sync is also the way into a repository mktrue did not make: the method without the template.
OPTIONS
--write- Write the changes instead of only listing them.
--adopt- Take the kit’s version of files never under management.
--restore- Put back a kit-owned file this repository deleted.
--target <name>- The agent target to render for. The default is claude-code.
--bench <dir>- The kit to render from. The default is the installed kit.
--help- Print this screen: the command’s usage, its flags and its exit codes.
EXIT STATUS
| 0 | true: the plan was printed, or written with --write. |
| 1 | findings: the plan holds one, .mktrue.json lists no gates, or a write failed before anything moved. |
| 2 | usage: there is no .mktrue.json or no bench, or .mktrue.json does not parse. |
| 4 | a decision is needed: a file changed both here and in the kit. |
EXAMPLES
The dry run, on a repository already at this kit version.
exit 0
mktrue syncmktrue: sync · kit 1.3.1 → 1.3.1 · dry runmktrue: 0 updates · 0 kept · 0 conflicts · 0 skipped · 0 removedmktrue: true · exit 0
Real output from mktrue 1.3.1, captured with NO_COLOR set.