basicmachines-co/basic-memory/bm-share

Share A Note

Copy a note from the configured primary project to a configured team project. This is the deliberate shared-write path. Automatic checkpoints and quick remembers stay personal.

Steps

1. Read ~/.codex/basic-memory.json, then the nearest project

.codex/basic-memory.json; project keys override user keys. Resolve:

• primaryProject
• teamProjects, a map of project ref to settings

1. If no team projects are configured, stop and ask the user to run setup or add a

target. Do not invent a team destination.

1. Read the source note from the user's argument or the current conversation. If

ambiguous, ask which note to share.

1. Pick the target. If there is more than one team project, ask which one.

1. Confirm before writing. The prompt should be specific:

Share "<title>" to <target>/<promoteFolder>?

1. Write the copy:

• route to the target project
• directory: target promoteFolder, default shared
• preserve the original content and useful frontmatter
• add shared_from: <source permalink> frontmatter when possible
• add - [context] Shared from <source permalink> as an observation

1. Confirm with the new team permalink.

Never share secrets, credentials, or private notes without an explicit yes.