momhq/mom

mom-fold

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.

Hot #3047 First seen Jun 11, 2026

Installation

$ npx skills add momhq/mom --skill mom-fold

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from momhq/mom.

npx skills add momhq/mom

Browse all from momhq/mom

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 60
License LICENSE
Default branch main
Open issues 10
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash(mom vault fold*), Bash(mom vault status*), Bash(test -f .mom-project.yaml*), Bash(command -v mom*), Bash(brew install momhq/tap/mom*)

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,549 B
  • docs SUMMARY.md 228 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 247 installs

SKILL.md

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.