@nexus-catalyst/nc-plugin-core

Shared HTTP SDK for the Nexus-Catalyst hook plugins. This is the common layer every tool plugin (cc-plugin, cursor-plugin, codex-plugin, grok-plugin, antigravity-plugin) builds on — it is not installed directly by end users.

What it provides

• The NC recall/store client (talks to NC_API_BASE_URL, default https://mcp.nexus-catalyst.com)
• Shared config resolution — the single API key at ~/.nexus-catalyst/config.json that all NC tool plugins read
• The <nc-context> block formatter used to inject recalled memories into a model's context
• Session/turn de-duplication and the short-prompt skip threshold
• Common types and utilities

Install

You don't install this directly — it is a dependency of the per-tool plugins. Install the plugin for your tool instead (e.g. @nexus-catalyst/cc-plugin).

Configuration

All plugins share one key, resolved in this order:

| Source | Notes | |--------|-------| | NC_PLUGIN_API_KEY env var | Highest precedence | | ~/.nexus-catalyst/config.json | Written by any plugin's set-key; shared across all NC tool plugins |

Get a Plugin API key at app.nexus-catalyst.com → Account → API Keys.

License

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