CLI (any terminal, any AI agent)

npx @nex-ai/nex register --email you@company.com

That's it. Now use it:

# Ask your knowledge graph
nex ask "who is Maria Rodriguez?"

# Ingest information
nex remember "Met with Maria Rodriguez, CTO of TechFlow. European expansion Q3, $2M budget."

# Or pipe from stdin
cat meeting-notes.txt | nex remember

# Search CRM records
nex search "TechFlow"

# CRUD operations
nex record list person --limit 10
nex task create --title "Follow up with Maria" --priority high
nex insight list --last 24h

# Build auto-recall hooks for any agent
nex recall "what do I know about TechFlow?"  # Returns <nex-context> XML block

# Build auto-capture hooks
nex capture "Agent conversation text..."  # Rate-limited, filtered

Install globally: bun install -g @nex-ai/nex

MCP Server (Claude Desktop, Cursor, Windsurf)

The MCP server is bundled inside @nex-ai/nex. No separate package needed.

{
  "mcpServers": {
    "nex": {
      "command": "nex-mcp",
      "env": { "NEX_API_KEY": "sk-your_key_here" }
    }
  }
}

Or without a global install:

{
  "mcpServers": {
    "nex": {
      "command": "npx",
      "args": ["-y", "@nex-ai/nex", "mcp"],
      "env": { "NEX_API_KEY": "sk-your_key_here" }
    }
  }
}

No API key? The server starts in registration mode — call the register tool with your email.

Proactive Notifications (Claude Code Channels)

The MCP server includes a built-in notification channel that pushes context updates directly into your Claude Code session — without you having to ask. This uses the Claude SDK Channels API.

What you get:

How to enable:

1. Install Nex globally (if not already):

   npm install -g @nex-ai/nex
   

2. Add the MCP server to your project (.mcp.json):

   {
     "mcpServers": {
       "nex": {
         "command": "nex-mcp",
         "env": {}
       }
     }
   }
   

3. Start Claude Code with channels enabled:

   claude --dangerously-load-development-channels server:nex
   

4. That's it. Notifications arrive as <channel> events in your session:

   ← nex: [technical_stack] MCP server utilizes experimental channel capability...
   ← nex: [deal_update | high] Meridian counter-offer moved to 12% equity split...
   

Configuration:

Set it in your .mcp.json:

{
  "mcpServers": {
    "nex": {
      "command": "nex-mcp",
      "env": { "NEX_NOTIFY_INTERVAL_MINUTES": "5" }
    }
  }
}

State persistence: Digest and notification timestamps are stored in ~/.nex/channel-state.json. Delete this file to force a fresh digest on next session start.

Requirements: Claude Code v2.1.80+, claude.ai login (API keys not supported for Channels), --dangerously-load-development-channels flag during research preview.

OpenClaw Plugin (auto-recall + auto-capture)

cp -r openclaw-plugin /path/to/openclaw/plugins/nex
cd /path/to/openclaw/plugins/nex && bun install && bun run build

Add to openclaw.json:

{
  "plugins": {
    "load": { "paths": ["/path/to/plugins/nex"] },
    "slots": { "memory": "nex" },
    "entries": {
      "nex": {
        "enabled": true,
        "config": {
          "apiKey": "sk-your_key_here"
        }
      }
    }
  }
}

See openclaw-plugin/README.md for details.

Claude Code Plugin (auto-recall + auto-capture)

cd claude-code-plugin && bun install && bun run build

Add hooks to ~/.claude/settings.json:

{
  "hooks": {
    "UserPromptSubmit": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "NEX_API_KEY=sk-your_key node /path/to/claude-code-plugin/dist/auto-recall.js",
        "timeout": 10000
      }]
    }],
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "NEX_API_KEY=sk-your_key node /path/to/claude-code-plugin/dist/auto-capture.js",
        "timeout": 5000,
        "async": true
      }]
    }]
  }
}

Slash commands and MCP server:

cp claude-code-plugin/commands/*.md ~/.claude/commands/    # /nex:recall, /nex:remember, /nex:scan, /nex:entities
claude mcp add nex -- nex-mcp                               # Full toolset

See claude-code-plugin/README.md for details.

SKILL.md (OpenClaw script-based)

For OpenClaw agents without the plugin, SKILL.md provides bash-script-based access:

# Register and get API key
bash scripts/nex-openclaw-register.sh your@email.com "Your Name"

# Query context
printf '{"query":"who is Maria?"}' | bash scripts/nex-api.sh POST /v1/context/ask

# Ingest text
printf '{"content":"Meeting notes..."}' | bash scripts/nex-api.sh POST /v1/context/text

# Scan project files
bash scripts/nex-scan-files.sh --dir . --max-files 10

See SKILL.md for the full API reference.