io.github.nex-crm/nex

Official

by nex-crm · TypeScript

Organizational context & memory for AI agents. Connect 100+ tools into one knowledge graph.

Organizational context and memory connecting 100+ tools into a knowledge graph.

Topics

contextcontext-engineeringmemoryaiai-agentclideveloper-toolsknowledge-graphmcpmcp-servernodejstypescript

README.md10 KBView on GitHub

Nex: Intelligence Layer for AI Agents

Nex turns AI agent conversations into a unified knowledge graph. Tell something to one agent, recall it from any other. Context follows you across tools — no copy-pasting, no re-explaining.

Supports Claude Code, OpenClaw, Cursor, Windsurf, Codex, Aider, Continue, Zed, and more. Adds context from Email, Meetings, Slack, HubSpot, Salesforce.

Talk to the team, share feedback, and connect with other developers building AI agents with Nex.

Quick Start

Install

bash

# Option A: install the nex-cli binary (no Node.js required)
curl -fsSL https://raw.githubusercontent.com/nex-crm/nex-as-a-skill/main/install.sh | sh

# Option B: install via npm (or bun/pnpm) — thin shim that delegates to nex-cli
npm install -g @nex-ai/nex

bash

# Create an account (or log in if you already have one)
nex register --email you@company.com

# Auto-detect your AI platforms and install hooks, MCP, slash commands
nex setup

nex setup detects your platforms (Claude Code, Cursor, Windsurf, etc.), installs hooks, scans project files, and writes config. After setup:

bash

nex ask "who is Maria Rodriguez?"
nex remember "Met with Maria, CTO of TechFlow. European expansion Q3, $2M budget."

Skills & Platform Rules

The core of this repo is a set of skills, slash commands, and agent instructions that teach any AI platform how to use Nex.

Slash Commands (`plugin-commands/`)

Drop these .md files into your agent's commands directory to get Nex slash commands:

Command	What it does
`/nex:recall <query>`	Search your knowledge base
`/nex:remember <text>`	Store information for later recall
`/nex:entities <query>`	Find people, companies, topics
`/nex:scan <dir>`	Scan project files into Nex
`/nex:integrate <provider>`	Connect an OAuth integration
`/nex:register <email>`	One-time account registration
`/nex:notify`	Check recent notifications

For Claude Code: cp plugin-commands/*.md ~/.claude/commands/

Platform Rules (`platform-rules/`)

Pre-written agent instructions that teach each platform how to use Nex tools. Copy the relevant file into your editor's config:

Platform	File	Destination
Cursor	`cursor-rules.md`	`.cursor/rules/`
Windsurf	`windsurf-rules.md`	`.windsurf/rules/`
GitHub Copilot	`vscode-instructions.md`	`.github/instructions/`
Zed	`zed-rules.md`	`.zed/rules/`
Aider	`aider-conventions.md`	`.aider/conventions/`
Cline	`cline-rules.md`	`.cline/rules/`
Continue	`continue-rules.md`	`.continue/rules/`
KiloCode	`kilocode-rules.md`	`.kilocode/rules/`
Codex	`codex-agents.md`	`.codex/agents/`
OpenCode	`opencode-agents.md`	`.opencode/agents/`

Platform Plugins (`platform-plugins/`)

Deeper integrations for editors that support plugin APIs:

Continue (continue-provider.ts) — Nex as a context provider for autocomplete
OpenCode (opencode-plugin.ts) — Session lifecycle hooks for context preservation
KiloCode (kilocode-modes.yaml) — Nex memory mode definitions
Windsurf (windsurf-workflows/) — Native workflow definitions for ask, remember, search, notify

Plugins

Claude Code Plugin

Full auto-recall and auto-capture via Claude Code hooks. Queries Nex before each prompt and captures conversation facts after each response.

bash

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

Then add hooks to ~/.claude/settings.json (see settings.json for the template) and register the MCP server:

bash

cp claude-code-plugin/commands/*.md ~/.claude/commands/
claude mcp add nex -- nex-mcp

The fastest path is just nex setup — it does all of this automatically.

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

OpenClaw Plugin

15+ tools, auto-recall, and auto-capture for OpenClaw agents.

bash

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

Add to openclaw.json:

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.

MCP Server (Claude Desktop, Cursor, Windsurf)

json

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

Or without a global install:

json

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

Remote MCP Server (no install required)

Connect directly to the hosted Nex MCP server. No local installation needed — works with any MCP client that supports Streamable HTTP transport.

json

{
  "mcpServers": {
    "nex": {
      "url": "https://mcp.nex.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-your_key_here"
      }
    }
  }
}

Get an API key at app.nex.ai/settings/developers.

Shell-only Agents (no Node.js)

Bash scripts for agents that can only run shell commands. Requires curl and jq.

bash

bash scripts/nex-openclaw-register.sh your@email.com "Your Name"
printf '{"query":"who is Maria?"}' | bash scripts/nex-api.sh POST /v1/context/ask
bash scripts/nex-scan-files.sh --dir . --max-files 10

Copy-Paste Bootstrap Prompt

Drop this into any terminal-capable AI agent to bootstrap Nex end-to-end:

text

Install and fully bootstrap Nex in this project from start to finish.

1. If the `nex` CLI is missing, install it globally with `npm install -g @nex-ai/nex`.
2. If Nex is not authenticated yet, ask me for the email address I want to use for registration, then continue. If Nex is already authenticated, reuse the existing account and key.
3. Run `nex setup` and complete the full install flow for every detected AI coding platform in this environment.
4. After setup, inspect integrations and connect the first available unconnected integration. Prefer this order when multiple choices are available: gmail, google-calendar, slack, salesforce, hubspot, attio, outlook, outlook-calendar. If OAuth is required, open the browser flow and wait for it to complete.
5. Run a fresh file scan for the current directory so the workspace is up to date.
6. After the scan finishes, trigger Nex compounding jobs by calling the authenticated `POST https://app.nex.ai/api/developers/v1/compounding/trigger` endpoint for these job types: `consolidation`, `pattern_detection`, and `playbook_synthesis`. Use the active Nex API key from the current environment or the config written by Nex setup.
7. Fetch the last 24 hours of insights with the insights endpoint or `nex insight list --last 24h`, then give me a clean digest with sections for Highlights, Risks, Opportunities, Open Loops, and Recommended Next Actions.
8. Finish by showing me:
   - what Nex installed
   - which integration was connected
   - how many files were scanned and ingested
   - whether the compounding/playbooks trigger succeeded
   - the formatted 24-hour insight digest

Do not stop after partial setup. Only pause if you need my email for registration or if an OAuth flow requires my interaction.

Development

Repo structure

text

bin/                    # Thin Node.js shims that delegate to nex-cli
claude-code-plugin/     # Claude Code hooks (auto-recall, auto-capture)
openclaw-plugin/        # OpenClaw plugin (15+ tools, auto-recall, auto-capture)
plugin-commands/        # Slash command definitions (.md files)
platform-rules/         # Agent instructions for 10 platforms
platform-plugins/       # Editor integrations (Continue, OpenCode, KiloCode, Windsurf)
scripts/                # Bash API wrappers for shell-only agents
server.json             # MCP Registry manifest

Build and test

bash

# Shims (syntax check only)
npm test

# Claude Code plugin
cd claude-code-plugin && bun install && bun run build && bun test

# OpenClaw plugin
cd openclaw-plugin && bun install && bun run build && bun test

How it works

npm package (bin/nex.js, bin/nex-mcp.js): Thin Node.js shims that find nex-cli on PATH or common install locations and delegate all commands. For npx @nex-ai/nex and MCP Registry compatibility.

The nex-cli binary is built and released from nex-crm/nex-cli. Install it with:

bash

curl -fsSL https://raw.githubusercontent.com/nex-crm/nex-as-a-skill/main/install.sh | sh

CI/CD

CI (ci.yml): Validates shims, builds + tests both plugins
Publish (publish-cli.yml): Auto-publishes to npm on push to main
MCP Registry (publish-mcp.yml): Publishes server.json to the MCP Registry on version tags

Environment Variables

Variable	Required	Default
`NEX_API_KEY`	Yes (or register)	—
`NEX_DEV_URL`	No (dev only)	`https://app.nex.ai`
`NEX_SCAN_ENABLED`	No	`true`
`NEX_SCAN_MAX_FILES`	No	`5`
`NEX_SCAN_DEPTH`	No	`20`
`NEX_NOTIFY_INTERVAL_MINUTES`	No	`15`

Architecture

mermaid

graph TD
    API["Nex Context Graph<br/><i>app.nex.ai API</i>"]
    CLI["nex-cli binary"]

    API --- CLI

    NEX["nex binary / npm shim"]
    MCP["MCP Server<br/><i>nex-mcp</i>"]
    OC["OpenClaw Plugin"]
    CC["Claude Code Plugin"]

    CLI --- NEX
    CLI --- MCP
    CLI --- OC
    CLI --- CC

    NEX -.- T1["Any terminal"]
    MCP -.- T2["Claude Desktop · Cursor<br/>Windsurf · ChatGPT"]
    OC -.- T3["OpenClaw agents"]
    CC -.- T4["Claude Code"]

License

MIT

Install

Configuration

Environment variables

NEX_API_KEYsecret

Your Nex API key. Sign up at https://nex.ai or use the 'register' tool to get one.

claude_desktop_config.json

{
  "mcpServers": {
    "nex": {
      "command": "npx",
      "args": [
        "-y",
        "@nex-ai/nex@0.1.53"
      ],
      "env": {
        "NEX_API_KEY": "<YOUR_NEX_API_KEY>"
      }
    }
  }
}

Topics

Nex: Intelligence Layer for AI Agents

Quick Start

Install

Sign up and configure

Skills & Platform Rules

Slash Commands (plugin-commands/)

Platform Rules (platform-rules/)

Platform Plugins (platform-plugins/)

Plugins

Claude Code Plugin

OpenClaw Plugin

MCP Server (Claude Desktop, Cursor, Windsurf)

Remote MCP Server (no install required)

Shell-only Agents (no Node.js)

Copy-Paste Bootstrap Prompt

Development

Repo structure

Build and test

How it works

CI/CD

Environment Variables

Architecture

License

Install

Configuration

Slash Commands (`plugin-commands/`)

Platform Rules (`platform-rules/`)

Platform Plugins (`platform-plugins/`)