IdentityDB

IdentityDB is a TypeScript package for building structured AI memory on top of relational databases.

What it is

IdentityDB stores memory as a graph made of:

• Topics — named nodes such as TypeScript, programming language, 2025, or I
• Facts — statements that connect multiple topics
• Fact-topic links — the relationships that turn one fact into a bridge between many topics

A single fact like I have worked with TypeScript since 2025. can connect the topics I, TypeScript, and 2025 at the same time.

Foundation scope

The first implementation pass focuses on:

• SQLite, PostgreSQL, MySQL, and MariaDB adapters
• Automatic schema initialization
• High-level APIs for topics and facts
• Pluggable ingestion so callers can use a small LLM to extract topics from free-form statements

Current status

This repository is in active foundation development.

See docs/plans/2026-05-11-identitydb-foundation.md for the current implementation plan.