@ijfw/memory-server

IJFW MCP memory server — the runtime backend that powers memory, metrics, update checks, and the extension sandbox for all supported AI coding agents.

Install

This package is installed automatically by @ijfw/install. You generally do not need to install it manually.

npm install -g @ijfw/memory-server

Extension CLI

IJFW ships a full extension system for installing and sandboxing third-party skills.

# Publisher key management
ijfw extension keygen <author>              # Generate an Ed25519 publisher keypair
ijfw extension trust <keyId> <publicKey>   # Add a publisher to your trusted store
ijfw extension trust-registry [<url>]      # Pull + apply the hosted publisher registry
ijfw extension untrust <keyId>             # Remove a publisher from your trusted store
ijfw extension trusted                     # List all trusted publishers

# Extension lifecycle
ijfw extension add <source> [flags]        # Install an extension (npm name, local path, or https git URL)
  --allow-unsigned                         #   Accept extensions with no signature
  --accept-untrusted                       #   Accept extensions signed by an untrusted publisher (prompts on TTY)
  --activate                               #   Auto-activate after install
ijfw extension activate <name>             # Activate an installed extension (enforces declared permissions)
ijfw extension deactivate                  # Deactivate the current extension

# Admin / registry maintainer (rare)
ijfw extension rotate-keys <oldKeyId> <newKeyId>   # Produce a signed rotation token
ijfw extension keygen-meta <author>                # Generate the registry meta-keypair
ijfw extension sign-registry <path>                # Sign a registry JSON file in place
ijfw extension verify-registry <path>              # Verify a registry JSON signature
ijfw extension registry-status                     # Show registry cache age + signature status

The rotation flow and registry maintainer docs live in docs/REGISTRY-MAINTAINER.md.

MCP Tools

| Tool | Description | |------|-------------| | ijfw_memory_store | Store a memory entry | | ijfw_memory_recall | Recall memory entries | | ijfw_memory_search | Full-text search over memories | | ijfw_memory_prelude | Load project context at session start | | ijfw_cross_project_search | Search memories across projects | | ijfw_metrics | Read cost + usage metrics | | ijfw_update_check | Check for IJFW updates | | ijfw_update_apply | Apply a pending IJFW update | | ijfw_prompt_check | Validate a prompt against IJFW rules | | ijfw_run | Run a sandboxed IJFW command |

Build (contributors)

cd mcp-server
npm install
npm test
node --experimental-sqlite --test test-*.js