ctxvault-sdk

Node.js SDK for CtxVault — Persistent Memory for AI.

Note: This is the programmatic SDK. For the MCP server (Claude, Codex, Cursor), use ctxvault-mcp.

Install

npm install ctxvault-sdk

Usage

const { CtxVault } = require('ctxvault-sdk');

const vault = new CtxVault({
  apiKey: 'cv_your_key',
  project: 'your-project',
  baseUrl: 'https://ctxvault.dev',
});

// Store a memory
await vault.remember({
  type: 'decision',
  title: 'Use PostgreSQL for persistence',
  content: 'Chose PostgreSQL with pgvector for vector search support.',
  tags: ['database', 'architecture'],
});

// Search memories
const results = await vault.recall('database decisions');

// Get context pack
const pack = await vault.contextPack('project architecture');
console.log(pack.pack);

// List all memories
const items = await vault.list({ status: 'verified' });

API

new CtxVault(options)

• apiKey (required) — Your API key
• project (required) — Project slug
• baseUrl (optional) — API base URL

vault.remember(item) — Store a memory item

vault.recall(query, options?) — Search memories

vault.contextPack(query, options?) — Generate context pack

vault.list(filters?) — List memory items

vault.verify(id) — Verify a candidate

vault.pin(id) — Pin a verified item

vault.deprecate(id, reason) — Deprecate an item

License

MIT