# bm-share

bm-share copies notes from your personal Basic Memory workspace to a shared team project with author attribution and source permalinks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 148 installs · ★ 4660 repo stars
- Author: basicmachines-co
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basicmachines-co/basic-memory/tree/HEAD/plugins/claude-code/skills/bm-share/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bm-share

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-share -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bm-share/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bm-share/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-share -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bm-share/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-share -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bm-share/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-share
```

2. **Manually: put the files in place**
- File: `.github/skills/bm-share/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-share -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-share
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bm-share/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-share -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/basicmachines-co/basic-memory/tree/HEAD/plugins/claude-code/skills/bm-share/SKILL.md

## When to use it
- 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
- /basic-memory:bm-share memory://decisions/auth-v2
- Share this decision note with the team project
- /basic-memory:bm-share Database Migration Plan

## Similar
- [memory-ingest](https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-ingest.md) — skill · 555 installs
- [memory](https://affpapa.org/en/nevibecode/skills/johnlindquist-memory.md) — skill · 363 installs
- [memory-research](https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-research.md) — skill · 527 installs
- [qmd](https://affpapa.org/en/nevibecode/skills/qmd.md) — skill · 4200 installs
- [wiki-query](https://affpapa.org/en/nevibecode/skills/wiki-query.md) — skill · 3600 installs
- [graph-colorize](https://affpapa.org/en/nevibecode/skills/graph-colorize.md) — skill · 2800 installs

From the same set: [basicmachines-co/basic-memory](https://affpapa.org/en/nevibecode/by/basicmachines-co/basic-memory.md) — 23 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
