Check Integration

Check ZCode Integration

Use this when Nowledge Mem setup is new, a memory tool is missing, or the user asks whether the integration is working.

Step 1: Verify the client

Run:

nmem --json status

If the command is missing, use the Nowledge Mem desktop app's bundled CLI installation, or install the standalone nmem-cli on a separate client machine. Do not replace a desktop-managed CLI with a standalone install unless the user asks for that.

If status fails:

• local machine: open Nowledge Mem Desktop and retry;
• remote machine: verify the URL and API key in the user's own client configuration;
• ZCode: check Settings → MCP → Plugin MCP servers, then reload/restart the Agent runtime.

Never put an API key in a command argument, plugin file, or log.

Step 2: Install for ZCode

In ZCode, open Settings → Plugins → Create → Add marketplace, add:

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

Install and enable nowledge-mem-zcode, then reload the Agent runtime. After a standalone repository update, use Marketplace sources → Refresh this marketplace, then Manage installed → Check for updates for nowledge-mem-zcode, and reload if components do not appear immediately.

Expected behavior

This ZCode package provides:

• Working Memory and Context Bundle: guided through Skills and MCP;
• Startup context: SessionStart hook injection when the local nmem CLI is reachable;
• Recall: guided proactive searches across memories and threads, plus conservative UserPromptSubmit hook recall for prompts that clearly need history;
• Distillation: guided durable saves using search-before-update/add;
• Status: CLI/MCP diagnostics;
• Threads: Stop hook transcript capture through nmem t sync --from zcode, plus explicit structured handoff summaries as fallback.

ZCode exposes hook transcripts as temporary JSONL files. This plugin copies the transcript_path during the Stop hook before asking nmem to import it. If a user's ZCode build does not fire Stop, use nowledge-mem-sync-now when a hook context exposes transcript_path, or save a handoff summary. Do not claim a transcript was imported unless nmem t sync --from zcode succeeded.

Local installation

For local testing, add the repository's ZCode marketplace or plugin directory from Settings → Plugins → Create → Add marketplace, install the ZCode package, enable it, and reload the Agent runtime. After package changes, refresh the marketplace source and use Manage installed → Check for updates.

Remote Mem

Do not edit installed plugin files. Configure the user's own ZCode MCP settings with:

nmem config mcp show --host zcode

Paste the generated host-owned MCP block into ZCode and reload the Agent runtime. This is the supported path for Cloud, Access Anywhere, self-hosted, or any endpoint requiring authentication.