global-memory

global-memory

Cross-project workplace memory for Claude Cowork and Claude Code. Plain markdown on disk, indexed and served by the Basic Memory MCP server, accessed by a forked memory-management skill so the same memory works from any selected workspace folder.

This is a fork of productivity:memory-management that swaps direct file I/O for MCP calls. Same data model, same files on disk, client-agnostic access.

What's inside

Component	Purpose
skills/memory-management/SKILL.md	Auto-triggered. Decodes shorthand, lookups via Basic Memory MCP, session lifecycle (start check + end write).
skills/memory-bootstrap/SKILL.md	/memory-bootstrap — interview-style first-time setup: seeds people, projects, acronyms, preferences.
skills/remember/SKILL.md	/remember <fact> — push a fact into memory. Classifies and routes to the right destination.
skills/memory-wire/SKILL.md	/memory-wire [root-dir] — injects the global-memory pointer block into per-project CLAUDE.md files. Auto-detects Cowork workspace path. Idempotent.
skills/reflect/SKILL.md	/reflect [days=7] — reads recent daily notes, identifies correction patterns, proposes updates to preferences. Writes proposals to decisions/ only — nothing applied without review.
skills/consolidate/SKILL.md	/consolidate [days=30] — scans daily notes for promotable facts (people, projects, decisions, glossary). Presents plan, awaits confirmation, then moves facts to permanent notes.
hooks/hooks.json	Hook manifest. SessionStart loads hot cache; Stop writes a session-close marker to today's daily note.
hooks/preload-hot-cache.sh	SessionStart hook. Reads CLAUDE.md from the vault and injects it into session context.
hooks/session-close.sh	Stop hook. Creates/appends a ## Session closed entry to today's daily note when a session ends.
scripts/inject-memory-pointer.sh	Adds the global-memory pointer block to per-project CLAUDE.md files. Idempotent.
.mcp.json	Registers the basic-memory MCP server, pointed at the memory project.
.claude-plugin/plugin.json	Plugin manifest.
.claude-plugin/marketplace.json	Marketplace manifest for claude plugins / /plugin install.

Prerequisites

1. Install Basic Memory:

   brew tap basicmachines-co/basic-memory
   brew install basic-memory
   

2. Create the Memory directory and register a Basic Memory project named memory pointing at it:

   mkdir -p ~/Documents/Claude/Memory
   basic-memory project add memory ~/Documents/Claude/Memory --default
   

   Verify with basic-memory status — it should report the project without errors.

The directory does not need to be populated yet. /memory-bootstrap handles seeding on first use.

Install

From the marketplace (recommended)

In Claude Code or Cowork:

/plugin marketplace add Turek/cowork-global-memory
/plugin install global-memory@cowork-global-memory

From a .plugin file (Cowork)

Build:

cd ~/Documents/Claude/global-memory
zip -r /tmp/global-memory.plugin . -x "*.DS_Store" -x ".git/*"

Drag /tmp/global-memory.plugin into Cowork.

From local source

claude plugins add ~/Documents/Claude/global-memory

First-time use

After install, in a fresh Cowork or Claude Code session:

/memory-bootstrap

The skill asks for: name and role, frequent contacts (up to ~10), active projects (up to ~8), daily acronyms / shorthand, and communication preferences. It then writes the seed notes to the right permalinks (claude, glossary, preferences, people/<slug>, projects/<slug>, index, today's daily/<date>).

Subsequent sessions auto-load the hot cache via the SessionStart hook, so Claude knows your people, acronyms, and active projects without needing to be told.

Day-to-day use

• Auto-decoding — just talk normally. "Ask todd to do the PSR for oracle" → Claude looks up todd, PSR, oracle via the hot cache and full glossary before acting.
• Explicit push — /remember <fact>. E.g. /remember Jane Smith is the new platform lead, prefers Slack DMs. The skill classifies the fact, picks the right permalink, writes it.
• First-time setup — /memory-bootstrap.
• Wire per-project CLAUDE.md files — /memory-wire [root-dir]. Runs the bundled injector script to append the global-memory pointer block to every CLAUDE.md under ~/Documents/Claude/Project*/ (or a custom root). Idempotent.

Lookup chain

For any non-trivial request: