SDK for change control. Enable Git-like capabilities like versioning, history, and blame in apps and AI agents.
npm install @lix-js/sdk  
> [!NOTE]
> Lix is in beta ยท Follow progress to v1.0 โ
Lix is an embeddable change control system that enables Git-like features such as history, versions (branches), diffs, or blame for any file format.
What makes Lix unique:
- Supports any file format - Track changes in .xlsx, .pdf, .json etc. via plugins.
- SQL powered - History, versions, and diffs are all queryable via SQL.
- Embedded - Runs as a single SQLite file, persistable anywhere (local FS, S3, your database).
---
๐ Go to lix.dev for more information โ
---
- AI agent sandboxing - Agents propose changes, humans review and approve before applying.
- Applications with change control - Branch/merge-style reviews, audit trails, and versioning for structured data.
``bash`
npm install @lix-js/sdk @lix-js/plugin-json
`ts
import { openLix, selectWorkingDiff, InMemoryEnvironment } from "@lix-js/sdk";
import { plugin as json } from "@lix-js/plugin-json";
// 1) Open a lix with plugins
const lix = await openLix({
environment: new InMemoryEnvironment(),
providePlugins: [json],
});
// 2) Write a file via SQL
await lix.db
.insertInto("file")
.values({
path: "/settings.json",
data: new TextEncoder().encode(JSON.stringify({ theme: "light" })),
})
.execute();
// 3) Query the changes
const diff = await selectWorkingDiff({ lix }).execute();
console.log(diff);
``
- Getting Started Guide - Build your first app with Lix
- Documentation - Full API reference and guides
- Discord - Get help and join the community
- GitHub - Report issues and contribute