cognitive-enzyme-hook

A Claude Code UserPromptSubmit hook that turns Cognitive Enzyme into a System 1 push layer: before every prompt reaches the model, it calls the Cognitive Enzyme server's /api/prime and injects the activated reflexes as context.

MCP's prime() is a pull (the agent must decide to call it). This hook makes it a push: the right intuitions appear automatically, every turn.

It never blocks your prompt. If the server is down, unreachable, times out, or returns an error, the hook silently exits without injecting anything.

Install

One-liner — wires ~/.claude/settings.json and installs the global bins if missing:

npx -y cognitive-enzyme-hook install

Options: --project (write ./.claude/settings.json instead), --url <CE_API_URL> and --token <CE_API_TOKEN> (written into env), --no-npm (skip the global bin install). It is idempotent — existing equivalent hook entries (including absolute-path setups) are detected and skipped, and the previous settings file is backed up as settings.json.bak. Also available: uninstall and status.

Manual alternative:

npm i -g cognitive-enzyme-hook   # or from a clone: npm i -g ./hooks/npm

then add the configuration below yourself.

Configure

Add to ~/.claude/settings.json (or a project .claude/settings.json):

{
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": [{ "type": "command", "command": "ce-prime-hook", "timeout": 10 }] }
    ],
    "SessionEnd": [
      { "hooks": [{ "type": "command", "command": "ce-capture-hook", "timeout": 30 }] }
    ],
    "PreCompact": [
      { "hooks": [{ "type": "command", "command": "ce-capture-hook", "timeout": 30 }] }
    ]
  },
  "env": {
    "CE_API_URL": "http://localhost:8420",
    "CE_API_TOKEN": "<your machine token>"
  }
}

ce-capture-hook distills the finished session's transcript into reusable memories via the server's /api/capture (System 2 write path); it fires on SessionEnd and PreCompact and never blocks.

Then open /hooks once (or restart Claude Code) to load it.

Zero-install alternative: use "command": "npx", "args": ["-y", "cognitive-enzyme-hook"]. Convenient, but npx resolves the package on every prompt — adds noticeable latency on the prompt critical path. Prefer the global install above.

Environment variables

| Variable | Default | Purpose | |---|---|---| | CE_API_URL | http://localhost:8420 | Cognitive Enzyme REST base URL | | CE_API_TOKEN | — | Static machine token (required when the server has auth enabled) | | CE_PRIME_TIMEOUT | 3 | Request timeout, seconds (kept short — it's on the prompt path) | | CE_PRIME_MAX | 6 | Max reflexes injected per prompt (token control) | | CE_PRIME_MIN_CONF | 0.4 | Minimum enzyme confidence to inject |

Requirements

• Node.js ≥ 18 (uses built-in fetch)
• A running Cognitive Enzyme server (python -m app)

License

MIT