bm-share

Copies a note from a personal Basic Memory project into a shared team project with attribution.

4.0k|282|Updated Dec 2, 2024
One-click install
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-share-basicmachines-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bm-share
Source: https://github.com/basicmachines-co/basic-memory/tree/main/plugins/claude-code/skills/bm-share
Command: npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-share-basicmachines-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using Basic Memory keep notes in personal projects by default, so decisions and knowledge never reach teammates. This Skill provides a deliberate, confirmed path to publish a note into a shared team project without accidentally leaking other personal content. ## Core Features & Use Cases - Controlled sharing: Copies a note from your primary project into a configured team project's promote folder, adding a shared_from frontmatter field and a context observation for attribution. - Safety guardrails: Requires explicit user confirmation before writing, never shares silently, and warns against sharing secrets or credentials. - Config-driven targets: Reads teamProjects and primaryProject from Claude settings files, routing to team projects by qualified name or external_id UUID. - Use Case: After capturing an architecture decision in your personal notes, run the share flow to publish it to my-team/shared/ so teammates and their AI assistants can find it in structured recall. ## Quick Start Ask the AI to share the current decision note with the team using the bm-share skill, then confirm the target project when prompted.

Frequently Asked Questions about bm-share

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I share a Basic Memory note with my team?▼

Invoke the bm-share skill with a note title or permalink, or say "share this with the team". The skill reads your configured teamProjects, asks you to confirm the target, then copies the note into the team's promote folder with attribution.

How do I configure team projects for sharing in Basic Memory?▼

Add a `teamProjects` map to the `basicMemory` block in your Claude settings.json, mapping each project reference to a `promoteFolder` (default `shared`). Project references can be workspace-qualified names like `my-team/notes` or external_id UUIDs.

Does sharing a note move it or copy it?▼

Sharing copies the note; the original stays in your personal project. Edits to either copy do not propagate to the other, so the shared version is a snapshot at share time.

Why does sharing fail when I pass a UUID as the project name?▼

Basic Memory only routes UUIDs via the `project_id` argument, not the `project` argument. Pass workspace-qualified names through `project` and external_id UUIDs through `project_id` when writing the shared note.

Can notes be shared to a team project automatically?▼

No. Auto-capture mechanisms like session checkpoints and bm-remember always stay in your personal project. Sharing only happens through this deliberate, confirmation-gated flow to prevent accidental exposure of private notes.