Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basicmachines-co/basic-memory --skill bm-share -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/bm-share/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bm-share/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set23

The whole set →
memory-quest memory-quest is a Claude Code skill that verifies an assistant’s connection to Basic Memory Cloud and records the final verification note for Mission 8. CX Codex +1 327installs memory-okf memory-okf — a skill for Claude Code that finds and fixes blockers to exporting a Basic Memory project as OKF v0.2. It runs before publishing, handing off a project, or checking an export bundle. CX Codex +1 305installs memory-agents The memory-agents Claude Code skill creates, runs, and checks Basic Memory Cloud agents. Agents follow instructions on notes and can start when someone creates a note in watched paths. CX Codex +1 268installs memory-doctor The memory-doctor Claude Code skill checks local Basic Memory projects and explains its findings. It runs when search misses or repeats notes, or a save seems to have gone missing. CX Codex +1 249installs bm-setup This Claude Code skill configures Basic Memory through a short interview. It starts when asked to set up Basic Memory or when /basic-memory:bm-setup is run. CX Codex +1 160installs bm-remember A skill for quick capture of thoughts, facts, or reminders into Basic Memory. Responds to /basic-memory:bm-remember or natural language like "remember that…" — saves text as-is, preserving your wording. CX Codex +1 155installs bm-status bm-status is a Claude Code skill that checks Basic Memory's current health and configuration, including CLI access, hook queues, and recent session checkpoints. CX Codex +1 154installs basic-memory basic-memory — a local MCP server that keeps your knowledge in Markdown files on disk and lets the AI read, write and search them. Useful when you are tired of re-explaining project context. CX Codex +1 ★ 4,660repo stars

Project sponsors

Companies that keep this analytics open