Skip to content

nowledge-co/nowledge-mem

v0.1.0MIT

Cross-tool memory for AI agents through Nowledge Mem skills and MCP.

GitHubOpen Website

Nowledge Mem Agent Plugin

Portable Agent Plugins package for clients that implement the Agent Plugins 1.0 standard.

Use this package when your AI client supports Agent Plugins but does not have a dedicated Nowledge Mem connector yet. If a native connector exists for your tool, install that first: native connectors can add lifecycle hooks, host-specific setup, and real transcript import that a portable package cannot guarantee.

What It Includes

  • plugin.json using the Agent Plugins 1.0 manifest schema
  • mcp.json registering the local Nowledge Mem Streamable HTTP MCP endpoint
  • Shared Nowledge Mem skills for startup context, recall, distillation, status checks, and handoff summaries

Install

Install this directory from an Agent Plugins-compatible client marketplace or from source:

https://github.com/nowledge-co/community/tree/main/nowledge-mem-agent-plugin

After install, start Nowledge Mem Desktop or point your local nmem CLI at your remote Mem server, then restart the client if it does not hot-reload plugins.

Local vs Remote Mem

The standard mcp.json deliberately points to local Mem:

http://127.0.0.1:14242/mcp/

Agent Plugins 1.0 allows literal HTTP headers, but does not define a safe cross-client credential reference for API keys. Do not publish private keys in this package.

For Nowledge Cloud, Access Anywhere, or self-hosted remote Mem, use the client's private MCP settings instead. The safest way to generate that config is:

nmem config mcp show --host <your-client>

If the CLI does not know your client yet, copy the generated URL and authentication values from Nowledge Mem app: Connectors -> AI Tools or Settings -> Mem access.

Capabilities

This package gives compatible agents a baseline memory surface:

  • Read Context Bundle / Working Memory at the start of work
  • Search memories and prior threads when context would help
  • Distill durable decisions, procedures, and debugging breakthroughs
  • Check Nowledge Mem status
  • Save an honest resumable handoff when a full transcript importer is unavailable

It does not claim automatic full-thread capture. Portable Agent Plugins expose skills and MCP, but lifecycle hooks and transcript access remain client-specific in Agent Plugins 1.0. Use a dedicated Nowledge connector when you need host-level thread sync.

Dedicated Connectors Still Win

Prefer the dedicated connector when your host has one: Claude Code, Codex, Gemini CLI, OpenClaw, OpenCode, Copilot CLI, Pi, OMP, Kimi Code, Hermes Agent, Proma, WorkBuddy, CodeBuddy, Alma, Cursor, or another supported host in the Nowledge Mem connector guide.

See the current list at:

https://mem.nowledge.co/docs/integrations

Development

The skills in this package are copied from nowledge-mem-npx-skills/skills. When updating shared skill behavior, keep both packages aligned and run the community plugin tests.

python3 -m pytest community/tests/plugin_e2e/test_key_plugins_e2e.py -q