@nexus-catalyst/grok-plugin

Automatic memory for Grok (xAI CLI). Nexus-Catalyst recalls relevant context from your past sessions and stores each turn.

How it works

Grok exposes a usable stop hook but no pre-prompt injection hook, so this plugin combines:

1. An AGENTS.md recall rule (rules/nexus-catalyst-memory.md) that has the model call NC's recall_context at the start of a task — recall is MCP-driven.
2. A stop hook that calls store_context after each turn completes.

See _docs/grok-support.md.

Prerequisites

• Node.js 18+
• A Nexus-Catalyst account — sign up at nexus-catalyst.com
• A Plugin API key from app.nexus-catalyst.com → Account → API Keys

Install

npm install -g @nexus-catalyst/grok-plugin
nc-grok install

Verify:

nc-grok status

Commands

nc-grok install     Install the NC AGENTS.md rule + stop hook
nc-grok uninstall   Remove NC entries (nothing else is touched)
nc-grok status      Show installation state

Configuration

One key works across all NC tool plugins. It is read from NC_PLUGIN_API_KEY or ~/.nexus-catalyst/config.json (shared — set it once with any plugin's set-key).

NC_API_BASE_URL overrides the endpoint (default https://mcp.nexus-catalyst.com).

License

MIT — see LICENSE. Part of the Nexus-Catalyst/cli-hooks monorepo. The memory service requires an NC account.