Docs
Start using Wenlan.
Install Wenlan, connect the AI tool you use, then save one decision and retrieve it. Your knowledge stays readable, searchable, and under your control.
Start here
Install Wenlan, save one decision, and retrieve it to confirm your setup.
Setup
Get started with Wenlan
Choose Claude Code, Codex, ChatGPT, or a local MCP client, then follow the steps to save and retrieve your first decision.
Wenlan team · Updated Oct 4, 2026 · Three steps
Matrix
Choose Your Wenlan Setup
Use the desktop app to manage your library, a plugin to work in Claude Code or Codex, or MCP to connect another AI tool.
Qi-Xuan Lu · Updated Oct 26, 2026 · 2 min read
After setup
Once setup works, learn how to start with useful context, save important details, review uncertain captures, and hand work off.
Workflow
Save a Decision and Reuse It
Keep the reason behind a decision, then find it in a new AI conversation without explaining it again.
Qi-Xuan Lu · Updated Oct 27, 2026 · 3 min read
Capture
Capture Quality
Decide what belongs in Wenlan: durable facts, decisions, lessons, gotchas, corrections, and project context.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Trust
Review and Trust
Understand how Wenlan keeps uncertain memory visible: pending captures, revisions, contradictions, rejections, confirm, and forget.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Concepts
How Your Knowledge Fits Together
Memories hold individual findings. Wiki pages connect them. A Brief helps your next AI conversation pick up the work.
Qi-Xuan Lu · Updated Oct 26, 2026 · 3 min read
Connect AI tools
MCP
Connect MCP Clients
Connect Claude Code, Codex, Cursor, Claude Desktop, Gemini CLI, Muse Code, ChatGPT, Claude.ai, Muse, and other MCP clients to Wenlan.
Qi-Xuan Lu · Updated Oct 27, 2026 · 5 min read
Plugin
Claude Code Plugin
Install the Wenlan plugin in Claude Code and check its connection.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Agents
Wenlan Agent Profiles and Client Attribution
See which AI client wrote a memory, inspect source_agent attribution, and manage trust or enabled state.
Qi-Xuan Lu · Updated Jul 10, 2026 · 4 min read
Knowledge and sources
Memory
Wenlan Memory Types and memory_type Values
Choose identity, preference, decision, lesson, gotcha, or fact based on why a capture should matter later.
Qi-Xuan Lu · Updated Jul 10, 2026 · 5 min read
Spaces
Spaces
Separate work, personal, client, and project memory, and understand how Wenlan resolves the active space.
Qi-Xuan Lu · Updated Oct 27, 2026 · 6 min read
Pages
Create and Update Wiki Pages
Turn related findings into a page you can read, follow its sources, and review changes when the underlying information changes.
Qi-Xuan Lu · Updated Oct 27, 2026 · 4 min read
Graph
AI Agent Knowledge Graph
Build a source-backed AI knowledge base that links people, projects, tools, observations, and relations without treating graph context as authority.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Portability
Import and Portability
Move selected durable context into Wenlan and keep Wenlan's readable artifacts portable outside the daemon.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Data and privacy
Local control
Wenlan Local Data and Privacy
Where Wenlan stores local AI work memory, what stays on your machine, and when connected model providers may see prompts.
Qi-Xuan Lu · Updated Oct 27, 2026 · 7 min read
Backup
Backup and Migration
Back up Wenlan's readable artifacts and daemon data together, then verify the restored runtime before trusting recall.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Versioning
Local Git History
Inspect built-in page revisions and, if you choose, your own Git history of readable files.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Runtime and settings
CLI
Wenlan CLI Commands and Service Management
Use the Wenlan CLI for setup, daemon status, doctor diagnostics, background service management, memory search, and MCP client wiring.
Qi-Xuan Lu · Updated Jul 10, 2026 · 5 min read
Configuration
Wenlan Configuration
Configure Wenlan spaces, MCP clients, daemon bind address, local paths, models, and keys without editing the database by hand.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Config
Environment Variables
Know which Wenlan environment variables are normal configuration, which are development-only, and which belong to eval or Windows repair paths.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Models
Models and Keys
Choose local memory mode or configure an optional on-device, local server, or cloud model for background language work.
Qi-Xuan Lu · Updated Oct 27, 2026 · 5 min read
Platforms
Platform Support
Understand how Wenlan runs on macOS, Linux, and Windows: service managers, local data paths, model backends, and Docker/VM caveats.
Qi-Xuan Lu · Updated Oct 27, 2026 · 5 min read
Lifecycle
Updates and Uninstall
Refresh Wenlan's local runtime, verify version health, restart MCP clients, and remove the service without losing data by accident.
Qi-Xuan Lu · Updated Oct 27, 2026 · 3 min read
Upgrade
Upgrade Notes
Read the practical upgrade path for Wenlan releases: what to rerun, what to verify, and what changed in the current public runtime shape.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Packages
Packages and Registries
Know which Wenlan package name maps to the plugin, runtime setup, MCP connector, Rust crates, and release binaries.
Qi-Xuan Lu · Updated Jun 24, 2026 · 4 min read
Developer reference
Reference
Commands and Tools
The essential Claude Code and Codex plugin commands, CLI commands, and MCP tools for running Wenlan day to day.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
API
HTTP API
Know the local daemon surfaces that the CLI, MCP connector, plugin, and local tools call under the hood.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
API
API Examples
Use the local daemon HTTP API from scripts when the CLI or MCP tools are not the right fit.
Qi-Xuan Lu · Updated Jun 24, 2026 · 6 min read
Types
Typed Clients
Use wenlan-types when a Rust tool needs to call the local daemon without relying on untyped JSON shapes.
Qi-Xuan Lu · Updated Jun 24, 2026 · 4 min read
Architecture
Architecture
How Wenlan is put together: one local daemon, thin clients, shared wire types, local artifacts, and retrieval owned by wenlan-core.
Qi-Xuan Lu · Updated Oct 27, 2026 · 7 min read
Retrieval
Advanced Retrieval Status
Understand how Wenlan retrieves context, how to evaluate it, and where experimental controls fit.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Experiments
Experimental Flags
Look up selected experimental switches in the released runtime and use them with isolated data.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Troubleshooting and help
Repair
Troubleshooting
Fix the common setup issues: daemon not running, MCP not connected, missing Claude commands, stale context, and support escalation.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
Diagnostics
Diagnostics and Issue Reports
Run the right checks before asking for help, separate daemon problems from client problems, and share only redacted output.
Qi-Xuan Lu · Updated Oct 27, 2026 · 2 min read
FAQ
FAQ
Short answers to the adoption questions people ask before and after installing Wenlan.
Qi-Xuan Lu · Updated Jun 24, 2026 · 4 min read
Glossary
Glossary
A quick map of Wenlan terms: memory, handoff, page, space, daemon, MCP, local index, provenance, and eval language.
Qi-Xuan Lu · Updated Oct 27, 2026 · 5 min read
Project
Project information for people who want to assess, build, or contribute to Wenlan.
Security
Security and Reporting
Report Wenlan vulnerabilities privately, redact diagnostic output, and understand the local daemon security boundary.
Qi-Xuan Lu · Updated Oct 27, 2026 · 4 min read
Evaluation
Evaluation
What Wenlan's published retrieval numbers mean, how they are generated, and what they do not claim.
Qi-Xuan Lu · Updated Jun 24, 2026 · 6 min read
Desktop
Use the Wenlan Desktop App
Add material, find and edit pages, inspect sources, review updates, and connect AI tools in the Wenlan desktop app.
Qi-Xuan Lu · Updated Oct 27, 2026 · 3 min read
Releases
Wenlan Changelog and Releases
See the current Wenlan release, shipped changes, recent milestones, and how to distinguish tagged releases from unreleased main work.
Qi-Xuan Lu · Updated Oct 27, 2026 · 5 min read
Releases
Releases and Versioning
Understand how Wenlan turns merged work into tagged releases, package versions, binaries, npm packages, and crates.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Roadmap
Check Whether a Feature Has Shipped
Check whether a feature is in your download, still in development, or only proposed.
Qi-Xuan Lu · Updated Oct 26, 2026 · 1 min read
Scope
Project Scope
What Wenlan is for, what it deliberately avoids, and how to decide whether it fits your AI work.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Development
Build from Source
Build the Wenlan daemon, CLI, MCP server, shared types, core crate, and plugin from the public repository.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Quality
Testing and CI
Understand which Wenlan checks run locally, which run in GitHub Actions, and which evals stay manual.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Development
Development Conventions
Codebase rules that keep Wenlan's daemon, CLI, MCP connector, shared types, and core logic maintainable.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Open source
Contributing
How to contribute useful bug reports, docs, eval cases, and code changes to Wenlan.
Qi-Xuan Lu · Updated Jun 24, 2026 · 5 min read
Already installed?
Make the memory loop habitual.
Start with the daily workflow, then use the reference docs when you need commands, MCP setup, or repair steps.