| name | mom-fold |
| description | Fold this project's newly captured sessions into the MOM markdown vault. Use when the user wants to wrap up, finish, close the session, save decisions, update memory, or prepare the vault before clearing context. |
| user-invocable | true |
| allowed-tools | Bash(mom vault fold*), Bash(mom vault status*), Bash(test -f .mom-project.yaml*), Bash(command -v mom*), Bash(brew install momhq/tap/mom*) |
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:
mom vault status
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:
MOM 0.40.1 available. Run `brew upgrade mom` or `mom self-update`
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.
