The version control system for AI agents

Note

Lix is in alpha · Follow progress to v1.0 →

---

Lix is a universal version control system that can diff any file format (.xlsx, .pdf, .docx, etc).

Unlike Git's line-based diffs, Lix understands file structure through plugins. Lix sees price: 10 → 12 or cell B4: pending → shipped, not "line 4 changed" or "binary files differ".

This makes Lix the ideal version control layer for AI agents operating on non-code formats.

Getting started

JavaScript · Python · Rust · Go

npm install @lix-js/sdk

import { openLix } from "@lix-js/sdk";

const lix = await openLix({
  environment: new InMemorySQLite()
});

await lix.db.insertInto("file").values({ path: "/hello.txt", data: ... }).execute();

const diff = selectWorkingDiff({ lix })

Excel file example

An AI agent updates an order status in orders.xlsx.

Before:

  | order_id | product  | status   |
  | -------- | -------- | -------- |
  | 1001     | Widget A | shipped  |
  | 1002     | Widget B | pending |

After:

  | order_id | product  | status   |
  | -------- | -------- | -------- |
  | 1001     | Widget A | shipped  |
  | 1002     | Widget B | shipped |

Git sees:

-Binary files differ

Lix sees:

order_id 1002 status: 

- pending
+ shipped

JSON file example

Even for structured text file formats like .json lix is tracking semantics rather than line by line diffs.

Before:

{"theme":"light","notifications":true,"language":"en"}

After:

{"theme":"dark","notifications":true,"language":"en"}

Git sees:

-{"theme":"light","notifications":true,"language":"en"}
+{"theme":"dark","notifications":true,"language":"en"}

Lix sees:

property theme: 
- light
+ dark

How Lix Works

Lix is a version control system that runs on top of SQL databases:

• Filesystem: A virtual filesystem for files and directories
• Branching: Isolate work in branches, compare, and merge
• History: Full change history with commits and diffs
• Change proposals: Built-in pull request-like workflows

┌─────────────────────────────────────────────────┐
│                      Lix                        │
│           (version control system)              │
│                                                 │
│ ┌────────────┐ ┌──────────┐ ┌─────────┐ ┌─────┐ │
│ │ Filesystem │ │ Branches │ │ History │ │ ... │ │
│ └────────────┘ └──────────┘ └─────────┘ └─────┘ │
└────────────────────────┬────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────┐
│                  SQL database                   │
└─────────────────────────────────────────────────┘

Read more about Lix architecture →

Learn More

• 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

Blog posts

• Introducing Lix: A universal version control system
• What if a Git SDK to build apps exists?
• Git is unsuited for applications
• Does a git-based architecture make sense?

License

MIT