mom-fold

Invoking this skill is the user's request to wrap up. Proceed with the flow below immediately — do not ask the user to confirm they want to fold.

Folding reads the events captured since the last fold and synthesizes them into the project's markdown vault under .mom/vault/. It is the end-of-session step that turns raw captured turns into navigable memory.

Preflight

Check that mom is on PATH:

command -v mom

If it is missing, tell the user MOM is not installed and ask permission to install it:

MOM is not installed. Install it now with Homebrew?
  brew install momhq/tap/mom
Source: https://github.com/momhq/mom

If the user agrees, run that command. If the user declines, stop. Do not install MOM without explicit permission.

Confirm a project is bound — capture and fold only work for a bound directory:

test -f .mom-project.yaml

If it is missing, the directory is unbound and nothing has been captured. Tell the user to bind first with /mom-project, then stop.

Run

mom vault fold

Folding is incremental — it only processes events newer than the last watermark — and uses an LLM engine, so it can take a moment. When it finishes, run:

and report a one-line summary: the new watermark offset, files written, and last fold time.

Rules

• Do not pass an --engine flag unless the user explicitly asked for a specific engine.
• If mom vault fold reports there is nothing new, say so — folding again is a safe no-op.
• Never edit files under .mom/vault/ by hand from this skill; folding owns them.
• CLI flag surface — never invent flags. Before using any flag on any mom subcommand, run <subcommand> --help and confirm the flag appears. If it is not listed, do not use it.

Postflight (version hint)

Any mom ... command may print a banner to stderr like:

If you see that line, finish the task first, then add one short line at the end of your reply suggesting the upgrade. Do not run the upgrade yourself.