Lians
Lians is a current-state and completion guard for AI coding agents. It recovers interrupted work, rejects stale task state, and blocks 'done' until the current task is ready for human review. It is for developers using AI coding agents like Claude Code, Codex, or Cursor who need reliable task continuity and evidence-backed completion.
✨ Key features
- Recover interrupted agent work across sessions.
- Reject stale state with repository and task binding.
- Guard completion with typed evidence and review gate.
- Require human review before marking tasks done.
- Local memory with no account or API key needed.
- Generate bounded project handoffs from current state.
🎯 Use cases
- Resume a coding task in a fresh chat after interruption.
- Prevent agents from reusing outdated checkpoints.
- Ensure tasks are not marked done without verified evidence.
- Hand off project context between Claude Code and Codex.
- Track task readiness with measured local and CI evidence.
📦 Installation
🧰 Requirements: Requires Python and optionally uv; works with existing AI accounts and editors; no Lians account or API key for local recovery.
For Codex, after installing uv, run:
codex mcp add lians --env LIANS_MCP_ENABLED_TOOLS=remember,recall,list_memories,correct_memory,forget_memory -- uvx --from "lians-sdk[mcp]" lians-mcp
For Python SDK:
pip install "lians-sdk[local]"
For development:
git clone https://github.com/Lians-ai/Lians.git
cd Lians
python -m pip install -e ".[dev]"
python scripts/test_all.py
🚀 Usage
from datetime import datetime, timezone
from lians import LocalLiansClient
memory = LocalLiansClient(db_path=".lians/memory.db")
memory.add(
agent_id="my-agent",
content="The project uses Python 3.12 and pytest.",
event_time=datetime.now(timezone.utc),
)
result = memory.recall(
agent_id="my-agent",
query="Which Python version and test runner should I use?",
)
⚠️ Good to know
Lians is under active development; recovery features are available, but the full Guard workflow is a developer preview, and desktop builds are release candidates pending platform signing.
❓ FAQ
Does Lians require an account or API key?
No, the free recovery path needs no Lians account, AI password, or provider API key.
Which AI tools does Lians support?
It supports Codex, Claude Code, Cursor, and other MCP clients.
How does Lians prevent stale state?
It binds checkpoints to current repository and task state, and invalidates old evidence when requirements change.
What does 'READY FOR HUMAN REVIEW' mean?
It is a handoff to a person, not a claim that the work is correct, approved, or safe to deploy.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.