---
title: Packages
description: Every workspace package, what it owns, and which siblings it imports.
---

## 1. The workspace

The workspace holds 15 packages, and 13 of them state a description in their own manifest. The last column quotes that manifest.

| Package | Directory | Description |
| --- | --- | --- |
| `@memhtml/cli` | `apps/cli` | The `memhtml` binary. |
| `@memhtml/consolidator` | `apps/consolidator` | The eve agent that distills candidate memories from raw transcripts. |
| `@memhtml/docs` | `apps/docs` | *none stated* |
| `@memhtml/mcp` | `apps/mcp` | The `memhtml-mcp` stdio server. |
| `@memhtml/contracts` | `packages/contracts` | Schemas, enums, errors, and path algebra. Zero I/O. |
| `@memhtml/domain` | `packages/domain` | Pure math: retention, decay, RRF, MMR, merge guards. |
| `@memhtml/eval` | `packages/eval` | Fixture corpus generator, the refusable retrieval discrimination gate, and the write-path discrimination arm. |
| `@memhtml/html` | `packages/html` | Parse and serialize the memory file format. |
| `@memhtml/index` | `packages/index` | SQLite schema, migrations, the git-driven indexer, and four-arm retrieval. |
| `@memhtml/integrations` | `packages/integrations` | Wire a coding agent (Claude Code, Codex, Cursor, OpenCode) to a memhtml store: MCP entry, hooks, instruction block, skill, receipt. |
| `@memhtml/llm` | `packages/llm` | Bedrock embeddings and structured output. |
| `@memhtml/sleep` | `packages/sleep` | Sleep-cycle phases as git commits. |
| `@memhtml/store` | `packages/store` | Git-backed file store: read, write, move, commit, status. |
| `@memhtml/telemetry` | `packages/telemetry` | *none stated* |
| `@memhtml/traces` | `packages/traces` | Streaming JSONL parser and trace indexer. |

`@memhtml/docs`, `@memhtml/telemetry` state no description in their manifest, so this table has nothing to quote.

## 2. Dependency direction

Dependencies point inward: a package imports the layers beneath it and none of the layers above. The column below is each manifest's own list of workspace dependencies, which is the same set TypeScript project references enforce at build time.

| Package | Imports |
| --- | --- |
| `@memhtml/cli` | `@memhtml/consolidator`, `@memhtml/contracts`, `@memhtml/domain`, `@memhtml/eval`, `@memhtml/html`, `@memhtml/index`, `@memhtml/integrations`, `@memhtml/llm`, `@memhtml/sleep`, `@memhtml/store`, `@memhtml/telemetry`, `@memhtml/traces` |
| `@memhtml/consolidator` | `@memhtml/contracts` |
| `@memhtml/docs` | `@memhtml/cli` |
| `@memhtml/mcp` | `@memhtml/cli`, `@memhtml/contracts`, `@memhtml/domain`, `@memhtml/html`, `@memhtml/index`, `@memhtml/llm`, `@memhtml/sleep`, `@memhtml/store`, `@memhtml/telemetry`, `@memhtml/traces` |
| `@memhtml/contracts` | - |
| `@memhtml/domain` | `@memhtml/contracts` |
| `@memhtml/eval` | `@memhtml/consolidator`, `@memhtml/contracts`, `@memhtml/domain`, `@memhtml/html`, `@memhtml/index`, `@memhtml/llm`, `@memhtml/sleep`, `@memhtml/store` |
| `@memhtml/html` | `@memhtml/contracts` |
| `@memhtml/index` | `@memhtml/contracts`, `@memhtml/domain`, `@memhtml/html`, `@memhtml/llm` |
| `@memhtml/integrations` | `@memhtml/contracts` |
| `@memhtml/llm` | `@memhtml/contracts` |
| `@memhtml/sleep` | `@memhtml/contracts`, `@memhtml/domain`, `@memhtml/html`, `@memhtml/index`, `@memhtml/llm`, `@memhtml/store` |
| `@memhtml/store` | `@memhtml/contracts`, `@memhtml/html` |
| `@memhtml/telemetry` | - |
| `@memhtml/traces` | `@memhtml/contracts`, `@memhtml/index` |

## 3. Provenance

A loader generates this page from `each package's own package.json` while the site builds, so no file in the repository holds it: both the description and the dependency list are read out of the manifest itself. Change the registry and this page changes with it.