Lians
Local first AI agent memory for Claude, Codex, Cursor and MCP clients, with recall, correction, deletion and self hosted deployment options
Quick Start
uvx --from 'lians-sdk[mcp]' lians-mcp Overview
Lians is a local first memory layer for AI coding tools that need to remember project facts across sessions. It works through MCP with Claude, Codex, Cursor, Gemini, Windsurf, Cline, OpenCode and other compatible clients, giving them a shared place to save decisions, completed work, open tasks and corrected facts. The simplest setup runs with uvx and stores memory in ~/.lians/mcp.db, so you do not need a Lians account, provider API key or hosted database for local use.
The more ambitious side is temporal memory. Lians can keep current facts separate from stale ones, reconstruct what was known at a past point in time and attach receipts to memory selection. That matters if you use agents for longer software projects where old plans often leak back into new work.
There are caveats. The project is young, public adoption is still small and several advanced capabilities are marked beta or tied to managed deployments. For a solo developer testing AI agent continuity, the local MCP path is the part to start with. For team or regulated use, treat it as promising infrastructure that still needs careful review.
Features
- Local MCP memory for AI coding tools
- SQLite storage for simple local use
- Docker Compose path for self hosted server deployments
- Current and point in time recall
- Memory correction, deletion and lineage tools
- Python and TypeScript SDKs
- Apache 2.0 licensed source
Use Cases
Specific ways to use Lians for your workflow.
Deployment Strategy
Recommended ways to host Lians in your own environment.