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 --write when 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

0true: the plan was printed, or written with --write.
1findings: the plan holds one, .mktrue.json lists no gates, or a write failed before anything moved.
2usage: there is no .mktrue.json or no bench, or .mktrue.json does not parse.
4a 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.

SEE ALSO