mom-project

Original：🇺🇸 English

Translated

Bind the current directory to a MOM project so captured memories are scoped to it. Use when the user wants to set up project scoping, bind a repo, declare a project id, rebind a directory, or asks about .mom-project.yaml.

3installs

Sourcemomhq/mom

Added on2026-05-19

NPX Install

npx skill4agent add momhq/mom mom-project

SKILL.md Content

View Translation Comparison →

Run only after the user explicitly asks to bind, rebind, or set up project scoping (or after the user accepts a nudge from

mom status

about an unbound directory).

A bound directory has a

.mom-project.yaml

file at its root declaring a project

id

. Memories captured while working in that directory are tagged with that id, and recall scopes to it by default.

Preflight

Check that

mom

is on PATH:

bash

command -v mom

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

text

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.

Flow

Check whether the current directory is already bound:
bash
```
test -f .mom-project.yaml && cat .mom-project.yaml
```
If the file exists, show the current
```
id
```
and ask the user to either keep it or rebind to a different one. Warn that rebinding does not merge memories from the old id — recall will only see memories tagged with the new id.
If the file does not exist, continue.
Propose an
```
id
```
. Default to the current directory's basename, lowercased, trimmed, with spaces replaced by dashes. Show the proposal and ask the user to confirm or pick a different one.
The id is an opaque label. Suggest something specific (for example
```
vendor/project
```
or
```
team-service
```
) if the user might sync memories with other machines or teammates — unrelated projects sharing the same id will collide.
Write the binding:
bash
```
mom project bind --id <chosen-id>
```
If the directory already declares a different id and the user agreed to rebind, append
```
--force
```
.
Tell the user to commit
```
.mom-project.yaml
```
to version control so the binding travels with the repo.

Rules

Never run
```
mom project bind
```
without first confirming the id with the user.
Never run
```
mom init
```
from this skill.
If
```
mom project bind
```
returns an error, surface the error and stop.
After a successful bind, confirm in one line that the directory is now bound to
```
<id>
```
.

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.