bm-share

name: bm-share description: Promote a note from your personal Basic Memory project to a shared team project, with attribution. Use when the user says "share this with the team", "publish this decision", or runs /basic-memory:bm-share. This is the deliberate way to write to a team workspace — auto-capture never does. argument-hint:

Share to a team project

Copy a note from the personal/primary project into a configured team project so teammates can see it. This is the only path by which the plugin writes to a shared project — session checkpoints and /basic-memory:bm-remember always stay personal.

Steps

1. Resolve config. Read .claude/settings.json (+ .local) basicMemory:

   • teamProjects — a map of <project-ref> → { "promoteFolder": "shared" }. These are the allowed share targets. <project-ref> is a workspace-qualified name (e.g. my-team-2/notes) or an external_id UUID.
   • primaryProject — the source project notes are read from.

   If teamProjects is empty, tell the user there's no share target configured and suggest adding one (or running /basic-memory:bm-setup), then stop. Don't invent a target.

2. Find the source note. From $ARGUMENTS (a title, permalink, or memory:// URL), read_note it from primaryProject. If $ARGUMENTS is empty (you were invoked from "share this"), use the note most clearly referenced in the conversation — confirm which one if there's any ambiguity. Capture its title, full content (including frontmatter), and source permalink.

3. Pick the target. If teamProjects has one entry, use it. If several, ask which team project to share to. Use that entry's promoteFolder (default shared).

4. Confirm before writing. This write is visible to teammates, so show the user what you're about to do — "Share '