veriova-sdk

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

For the MCP server (Claude, Codex, Cursor), use veriova-mcp instead.

Install

npm install veriova-sdk

Quick start

const { veriova } = require("veriova-sdk");

const cv = new veriova({ apiKey: "cv_..." });

// Push memory candidates
await cv.push("my-project", [
  { type: "decision", title: "Use PostgreSQL", content: "Chose pgvector for semantic search.", importance: 8 },
  { type: "convention", title: "Snake case filenames", content: "All source files use snake_case." },
]);

// Semantic search
const results = await cv.search("my-project", "database choice");

// Context pack for LLM injection
const ctx = await cv.context("my-project", "how do we handle auth?");
console.log(ctx.pack); // inject into your system prompt

API

Constructor

new veriova({ apiKey, baseUrl?, timeout? })

| Option | Default | Description | |--------|---------|-------------| | apiKey | required | Your API key (cv_...) | | baseUrl | https://veriova.com | API base URL | | timeout | 30000 | Request timeout in ms |

Projects

cv.projects()                                      // List all projects
cv.createProject(name, slug, description?)         // Create a project

Memory

cv.push(projectSlug, items)                        // Push memory candidates
cv.search(projectSlug, query, k?)                  // Semantic search (default k=10)
cv.context(projectSlug, query, maxTokens?)         // Context pack for LLM injection
cv.listMemory(projectSlug, { status?, type? })     // List items with filters
cv.getMemory(memoryId)                             // Get a single item
cv.verify(memoryId)                                // Mark as verified
cv.pin(memoryId)                                   // Pin (prevents decay)
cv.deprecate(memoryId)                             // Deprecate an item
cv.reVerify(memoryId)                              // Re-verify an item
cv.supersede(memoryId, newContent)                 // Replace content, link old item

Memory item types: decision, convention, pattern, lesson, snippet, reference

Scaffold

cv.scaffoldAvailable()                             // List available templates and skills
cv.scaffold(projectSlug, { targets?, templates?, skills?, dryRun? })
// targets: "claude", "cursor", "codex", "all"
// templates: "core", "strict", "review"

Skills

cv.listSkills()                                    // List account skills
cv.createSkill({ name, trigger_description, procedure, context_keys?, language?, tags? })
cv.getSkill(slug)                                  // Get skill with resolved context
cv.installSkill(skillId)                           // Install from public registry
cv.skillRegistry({ q?, language?, tag? })          // Browse public registry

Pulse

cv.pulseProfile()                                  // Developer skill profile
cv.pulseTrends(days?)                              // Engagement trends (default 30d)
cv.pulseSessions(limit?)                           // Recent sessions (default 10)

Health

cv.health()                                        // API health check

Error handling

const { veriova, veriovaError } = require("veriova-sdk");

try {
  await cv.push("my-project", items);
} catch (err) {
  if (err instanceof veriovaError) {
    console.error(err.message, err.statusCode);
  }
}

License

MIT