Skip to main content
Nowledge MemNowledge Mem

ZCode × Nowledge Mem

Install the native Nowledge Mem ZCode plugin with MCP, Skills, commands, and lifecycle hooks.

For your agent

Paste this into ZCode:

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update the Nowledge Mem ZCode plugin from https://github.com/nowledge-co/zcode-plugin. Verify with nmem status, a Context Bundle or Working Memory check, and one short ZCode session that should appear under nmem t list --source zcode. If Stop did not capture the session, report that clearly and save a handoff summary instead.

ZCode supports plugin packages with .zcode-plugin/plugin.json, .mcp.json, skills/, commands/, and hooks/hooks.json. Nowledge Mem publishes a standalone ZCode plugin that uses all of those surfaces.

Before You Start

  • Nowledge Mem is running locally, or you have a reachable remote Mem server
  • ZCode is installed
  • nmem works on the same machine as ZCode
nmem status

Setup

Add the plugin marketplace source:

https://github.com/nowledge-co/zcode-plugin

In ZCode:

  1. Open Settings → Plugins → Create → Add marketplace.
  2. Add https://github.com/nowledge-co/zcode-plugin.
  3. Install and enable nowledge-mem-zcode.
  4. Restart or reload ZCode Agent.

For Cloud, Access Anywhere, self-hosted, or another authenticated Mem endpoint, keep the plugin installed and configure the ZCode-owned MCP settings with:

nmem config mcp show --host zcode

Paste the generated server into ZCode's MCP settings and reload the Agent runtime.

Verify

Ask ZCode:

Search my memories for recent decisions about this project.

Success means the ZCode Agent can call the Nowledge Mem MCP tools and returns results or a clean empty result.

Then run one short ZCode session and check:

nmem t list --source zcode

You should see the imported ZCode thread after the Stop hook runs.

Session Capture

The plugin copies ZCode's temporary hook transcript_path during the Stop hook, then imports it with:

nmem t sync --from zcode --session-dir <transcript_path> --session-id <session-id> --all-projects --apply

ZCode documents hook transcript files as temporary. The plugin copies them before import, but you should still verify after install because older ZCode builds had public reports of Stop hooks not firing. If capture does not happen, run the nowledge-mem-sync-now command when a hook context exposes transcript_path, or save a nowledge-mem-save-handoff summary.

Update

In ZCode, open Settings → Plugins → Marketplace sources, refresh https://github.com/nowledge-co/zcode-plugin, then use Manage installed → Check for updates for nowledge-mem-zcode. Reload the Agent runtime after an update.

On this page

Before You StartSetupVerifySession CaptureUpdateRelated