Quick Start

Install the CLI

npm install -g @memnexus-ai/cli

Authenticate

mx auth login

Paste your API key when prompted (input is masked). Verify it worked:

mx auth status

Connect your AI tools

Run this from inside your project directory (it needs a git repo to install the CommitContext hook):

cd ~/your-project
mx setup

This configures MCP for your AI coding tools (Claude Code, Copilot, Cursor, etc.) and installs the CommitContext post-commit hook — which automatically captures the reasoning behind every commit as a searchable memory.

Create a memory

mx memories create \
  --conversation-id NEW \
  --content "MemNexus uses graph storage and vector embeddings for semantic search." \
  --topics "memnexus,architecture,decision"

Search for it

mx memories search --query "what database does memnexus use"

The semantic search finds the memory even though you searched by meaning, not exact keywords.

Try CommitContext

Make a commit in your project to see CommitContext capture it automatically:

git commit --allow-empty -m "test: verify commit context"

Wait a few seconds, then check:

mx commit-context list

You should see your commit listed with a summary. From now on, every commit automatically creates a searchable memory with the reasoning behind your changes.

Install the SDK

npm install @memnexus-ai/mx-typescript-sdk

Create and search

import { MemnexusClient } from "@memnexus-ai/mx-typescript-sdk";

const client = new MemnexusClient({
  apiKey: process.env.MX_API_KEY,
});

// Create a memory
const memory = await client.memories.create({
  content: "MemNexus uses graph storage and vector embeddings for semantic search.",
  topics: ["memnexus", "architecture", "decision"],
});

console.log("Created:", memory.id);

// Search by meaning
const results = await client.memories.search({
  query: "what database does memnexus use",
  limit: 5,
});

for (const result of results.data) {
  console.log(`[${result.score.toFixed(2)}] ${result.memory.content}`);
}

Create a memory

curl -X POST https://api.memnexus.ai/api/memories \
  -H "Authorization: Bearer $MX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "MemNexus uses graph storage and vector embeddings for semantic search.",
    "topics": ["memnexus", "architecture", "decision"]
  }'

Search for it

curl -X POST https://api.memnexus.ai/api/memories/search \
  -H "Authorization: Bearer $MX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "what database does memnexus use",
    "limit": 5
  }'