nowledge-mem-plugins

Nowledge Mem Plugins

Claude Code plugin marketplace for personal knowledge base management with Nowledge Mem.

Why This Plugin?

Nowledge Mem provides an official MCP server. Here's why you might prefer this plugin instead:

Aspect	MCP Server	This Plugin (Skill)
Token Usage	Tool descriptions injected into every request	Minimal tokens (keyword list only)
Activation	Always loaded	On-demand, triggered by keywords
Context Window	Consumes tokens constantly	Only uses tokens when invoked
Features	All-in-one (Obsidian, web search, threads, etc.)	Core memory functions only
Customization	Cannot disable unwanted tools	Minimal, focused feature set
Session Persist	❌ Not supported	✓ Save Claude Code & Codex sessions

TL;DR: MCP tools consume tokens in every conversation turn, even when unused. This skill only costs tokens when you actually need it, with just the features you need—keeping your context window clean for the work that matters.

Features

• Search memories with semantic similarity
• Add new memories with metadata (labels, importance, temporal context)
• Persist Claude Code/Codex CLI sessions to knowledge base
• Progressive disclosure for thread content (expand on demand)
• Update and delete memories
• List all labels

Installation

Via Plugin Manager

# Add marketplace
/plugin marketplace add ferstar/nowledge-mem-plugins

# Install plugin
/plugin install nm

Manual Installation

# Clone the repository
git clone https://github.com/ferstar/nowledge-mem-plugins.git

# Test locally
claude --plugin-dir ./nowledge-mem-plugins

Configuration

Create a .env file based on .env.example:

NOWLEDGE_MEM_API_URL=https://your-api-endpoint
NOWLEDGE_MEM_AUTH_TOKEN=your-auth-token

Important: The .env file must be placed in the cache directory, not the marketplaces directory:

# ✗ Wrong location
~/.claude/plugins/marketplaces/nowledge-mem-plugins/skills/nowledge-mem/.env

# ✓ Correct location
~/.claude/plugins/cache/nowledge-mem-plugins/nm/<version>/skills/nowledge-mem/.env

You can find the exact path by running the skill and checking the "Base directory" shown in the output.

Alternatively, set environment variables directly in your shell profile.

Usage

Once the plugin is loaded, the skill triggers automatically based on keywords like:

• 记忆, 知识库, 保存会话, 搜索记忆
• memory, knowledge, save, search, persist, recall

Quick Commands

# Search memories
nm search "Python async patterns"

# Add a memory
nm add "Content to remember" --title "Title" --labels "tag1,tag2"

# Persist current session
PROJECT_PATH=/path/to/project nm persist

# View full thread
nm expand <thread_id>

# Check connectivity
nm diagnose

Repository Structure

nowledge-mem-plugins/
├── .claude-plugin/
│   ├── marketplace.json      # Marketplace catalog
│   └── plugin.json           # Plugin manifest
├── skills/
│   └── nowledge-mem/
│       ├── SKILL.md          # Skill definition
│       ├── scripts/          # CLI source code
│       │   ├── cli.py
│       │   ├── api.py
│       │   ├── config.py
│       │   ├── search.py
│       │   └── session.py
│       ├── references/       # Documentation
│       │   ├── command_reference.md
│       │   ├── configuration.md
│       │   ├── troubleshooting.md
│       │   └── usage_patterns.md
│       ├── pyproject.toml
│       └── .env.example
├── README.md
└── .gitignore

License

MIT