Skip to main content
The Node SDK ships as two npm packages under the @rubric-app scope. Pick the one matching what you’re building.

​
@rubric-app/claude-code

The drop-in CLI that gates Claude Code tool calls through your policies. Most users want this one.
Full setup in the Claude Code adapter page.

​
@rubric-app/core

Framework-neutral building blocks. Use this when you’re writing your own adapter (Cursor, Windsurf, an in-house framework, anything not already in /adapters/).
The exports are documented in Core building blocks.

​
Requirements

  • Node.js 22+ for both packages
  • macOS or Linux for the Claude Code adapter (the daemon needs launchd or systemd; Windows is on the roadmap)
  • @rubric-app/core runs anywhere Node 22 runs

​
Configuration

The SDK reads three values from env vars when they’re not passed explicitly: The Claude Code CLI uses its own variants (RUBRIC_ENROLLMENT_TOKEN, RUBRIC_AGENT_NAME, RUBRIC_API_URL) and stores them in ~/.config/rubric/config.json so subsequent boots don’t need them in the environment.