Skip to content

Npm Package

The npm package is Hypercontext's TypeScript/Node.js SDK. It is designed for Node applications that want the core context, archive, memory, scoring, diff, parsing, and tool-registry helpers without the Python runtime.

Install

npm install hypercontext-node-sdk

If you are using TypeScript, add the usual compiler tooling for your app:

npm install -D typescript ts-node @types/node

What The npm Package Gives You

  • context compression and retrieval helpers
  • lineage tracking and parent selection
  • persistent memory
  • fitness and scoring helpers
  • unified diff helpers
  • structured output parsing
  • a lightweight tool registry with middleware hooks
  • small agent primitives such as TaskAgent and MetaAgent

What It Does Not Ship

  • the Python CLI
  • the TUI
  • the stdio MCP daemon
  • the HTTP browser launcher
  • the Python provider runtime

If you need the full operational runtime, install the Python package instead.

Start Here

For detailed install and usage examples, read the package installation page:

For the public registry page, see:

Use the npm package when:

  • your app is a Node.js or TypeScript project
  • you want the Hypercontext utilities directly in application code
  • you are building around TaskAgent, MetaAgent, the parser helpers, or the tool registry

Use the Python package when:

  • you want the CLI, TUI, MCP daemons, browser dashboard, or provider runtime
  • you are integrating with Claude Desktop, Codex, or other MCP clients

Example Imports

import {
  ContextCompressor,
  ContextRetriever,
  LineageTracker,
  PersistentMemory,
  FitnessEvaluator,
  StructuredOutputParser,
  EnhancedToolRegistry,
  LoggingMiddleware,
} from "hypercontext-node-sdk";