@nex-ai/nex

Nex CLI provides organizational context & memory to AI agents across 10+ platforms.

Install

# Install globally
npm install -g @nex-ai/nex

# Or run directly (no install)
npx @nex-ai/nex ask "who is Maria?"

Quick Start

# 1. Register for an API key
nex register --email you@company.com

# 2. Set up your platforms (auto-detects installed tools)
nex setup

# 3. Query your knowledge
nex ask "what's the latest on the Acme deal?"

Supported Platforms

nex setup auto-detects and configures these platforms:

All MCP-based platforms use the same server entry:

{
  "nex": {
    "command": "npx",
    "args": ["-y", "@nex-crm/mcp-server"],
    "env": { "NEX_API_KEY": "sk-..." }
  }
}

Setup Command

nex setup                          # Auto-detect platforms, install plugin, scan files, create .nex.toml
nex setup --with-mcp               # Also write MCP config to all detected platforms
nex setup --platform cursor        # Install for a specific platform only
nex setup --no-plugin              # Only create config files, skip hooks/commands
nex setup --no-scan                # Skip file scanning during setup
nex setup status                   # Show all platforms, install status, and connections

Default behavior (no flags):

• Claude Code: installs hooks + slash commands (no MCP — avoids filling context windows)
• Other platforms: detected but MCP not written until --with-mcp is passed
• Scans current directory and ingests new/changed files into Nex
• Creates .nex.toml project config with commented defaults
• Syncs API key to ~/.nex-mcp.json (shared config)

Single install: npm install -g @nex-ai/nex bundles everything — the Claude Code plugin hooks, slash commands, and MCP server are all included. No separate packages needed.

Tip: AI agents don't automatically know about Nex. Explicitly tell your agent to "use Nex for context and memory" in your prompts or CLAUDE.md instructions.

Project Config: .nex.toml

Per-project settings file created by nex setup. All fields are optional.

[auth]
# api_key = "sk-..."          # Prefer NEX_API_KEY env var or ~/.nex/config.json

[hooks]
# enabled = true              # Master kill switch for all hooks

[hooks.recall]
# enabled = true              # Auto-recall context on each prompt
# debounce_ms = 30000

[hooks.capture]
# enabled = true              # Auto-capture on conversation stop
# min_length = 20
# max_length = 50000

[hooks.session_start]
# enabled = true              # Load context on session start

[scan]
# enabled = true
# extensions = [".md", ".txt", ".csv", ".json", ".yaml", ".yml"]
# ignore_dirs = ["node_modules", ".git", "dist", "build", "__pycache__"]
# max_files = 5
# max_file_size = 100000
# depth = 2

[mcp]
# enabled = false             # Set to true by `nex setup --with-mcp`

[output]
# format = "text"             # "text" | "json"
# timeout = 120000

Resolution order: CLI flags > .nex.toml > env vars > ~/.nex/config.json > defaults

Commands

Knowledge Graph

nex ask <query>              # Query with natural language
nex remember <content>       # Ingest text (meeting notes, emails, docs)
nex recall <query>           # Query → XML-wrapped for agent injection
nex capture [content]        # Rate-limited ingestion for agent hooks
nex artifact <id>            # Check processing status
nex search <query>           # Search CRM records by name
nex insight list [--last 24h]  # Recent insights

Integrations

nex integrate list                        # Show all integrations with connection status
nex integrate connect email google        # Connect Gmail via OAuth
nex integrate connect messaging slack     # Connect Slack
nex integrate disconnect <id>             # Disconnect by connection ID

Supported providers: Gmail, Google Calendar, Outlook, Outlook Calendar, Slack, Attio, HubSpot, Salesforce.

CRM Records

nex object list              # List object types (person, company, deal)
nex record list person --limit 10
nex record create person --data '{"name":"Jane Doe"}'
nex record upsert person --match email --data '{"name":"Jane","email":"jane@co.com"}'
nex record update <id> --data '{"phone":"+1234"}'
nex record delete <id>
nex record timeline <id>

Tasks & Notes

nex task create --title "Follow up" --priority high --due 2026-04-01
nex task list --assignee me --search "follow up"
nex task update <id> --completed
nex note create --title "Call notes" --content "..." --entity <record-id>

Relationships & Lists

nex rel list-defs
nex rel create <record-id> --def <def-id> --entity1 <id1> --entity2 <id2>
nex list list person
nex list add-member <list-id> --parent <record-id>
nex list-job create "enterprise contacts in EMEA"

File Scanning

On session start, Nex automatically scans project files and ingests changed content.

Default text-based extensions: .md, .txt, .csv, .json, .yaml, .yml

Document formats (handled separately): .docx, .doc, .odt, .xlsx, .xls, .pptx, .ppt, .pdf

Configure via .nex.toml [scan] section or environment variables (NEX_SCAN_ENABLED, NEX_SCAN_EXTENSIONS, etc.).

Config & Sessions

nex config show              # Resolved config (key masked)
nex config set default_format text
nex config path              # ~/.nex/config.json
nex session list             # Stored session mappings
nex session clear

Global Flags

--api-key <key>     Override API key (env: NEX_API_KEY)
--format <fmt>      json | text (default for integrate list) | quiet
--timeout <ms>      Request timeout (default: 120000)
--session <id>      Session ID for multi-turn context
--debug             Debug output on stderr

Stdin Support

ask, remember, and capture read from stdin when no argument is provided:

cat meeting-notes.txt | nex remember
echo "what happened today?" | nex ask
git diff | nex capture

Exit Codes

Development

npm install
npm run build     # TypeScript → dist/
npm run dev       # Run with tsx (no build)
npm test          # Unit tests
NEX_DEV_URL=http://localhost:30000 nex ask "test"  # Local API