bm-share — Claude Code skill: what it does, how to install
bm-share copies notes from your personal Basic Memory workspace to a shared team project with author attribution and source permalinks.
AGPL-3.0 148 installs ★ 4,660 updated 2026-10-24
npx skills add basicmachines-co/basic-memory --skill bm-share -a claude-codeWhat bm-share does
The skill handles deliberate note exports to collaborative team projects. Automated memory capture and session logs always stay inside your personal scope. That prevents accidental leaks of unfinished drafts. Before writing anything to a shared destination, the assistant reads the note with bm_read and asks for explicit approval.
Configuration comes from the basicMemory settings block. The agent inspects CLAUDE_CONFIG_DIR when present, or falls back to ~/.claude/settings.json, followed by workspace settings overrides. Valid destinations must exist in the teamProjects map.
Published entries become independent copies created via bm_write. Later modifications to the personal note will not sync to the team repository. Without configured entries in teamProjects, execution stops immediately.
What it helps with
- publish an architectural decision into a shared team repository
- hand off a personal research note to colleagues while preserving metadata
- track note provenance through the shared_from attribute
- prevent unvetted session memory from leaking into collaborative projects
Example prompts for the agent
- /basic-memory:bm-share memory://decisions/auth-v2
- Share this decision note with the team project
- /basic-memory:bm-share Database Migration Plan
How to install bm-share
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-share -a claude-code2Manually: put the files in place
~/.claude/skills/bm-share/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bm-share/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-share -a codex2Manually: put the files in place
.agents/skills/bm-share/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-share -a cursor2Manually: put the files in place
.cursor/skills/bm-share/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-share2Manually: put the files in place
.github/skills/bm-share/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-share -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-shareManually: put the files in place
.devin/skills/bm-share/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-share -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bm-share
How to install bm-share in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill bm-share -a claude-code in your terminal.
What does the bm-share skill do?
It explicitly copies a selected note from your primary Basic Memory workspace to a team project. The tool keeps frontmatter types and appends source attribution.
Do updates to the original note sync to the team project?
No. The command creates a standalone duplicate, so later edits in your personal workspace never propagate to teammates automatically.