Skip to content

FAQ

FAQ

Short answers to the adoption questions people ask before and after installing Wenlan.

Qi-Xuan LuUpdated 4 min read

At a glance

01

Wenlan is a local-first LLM wiki for AI work: agents capture what they learn, sources ground the result, and the daemon keeps pages usable across clients and sessions.

02

Use this page when you need the short answer, then follow the linked docs for setup, data, packages, troubleshooting, or project scope.

01

Is Wenlan just memory?

Wenlan includes a local memory substrate, but that is not the product headline. The product is a source-backed LLM wiki where decisions, context, handoffs, and pages remain useful across sessions and tools.

That distinction matters because Wenlan is designed around the work loop: brief, capture, recall, handoff, distill, inspect, and keep going.

Read project scope

02

Which install path should I use?

Use the Claude Code plugin if Claude Code is your main work surface. It gives you /setup, /brief, /capture, /handoff, /distill, and the plugin-level workflow.

Use npx -y wenlan setup when you want Wenlan from Codex, Cursor, Claude Desktop, Gemini CLI, VS Code, or another MCP client.

Compare package names

03

Do I need the desktop app?

No. The daemon, CLI, and MCP connector are the product path. The desktop app is optional and lives in the main repository's AGPL-3.0-only app/ crate.

If you only want agents to use Wenlan, install the plugin or runtime setup and verify the MCP route. You do not need a GUI.

Read desktop status

04

Where does data live?

Wenlan keeps the daemon database in the operating system's application data directory and keeps readable artifacts under ~/.wenlan.

The core loop is local-first. Optional model or API-key choices can add more language features, but they are explicit configuration decisions.

Read data and privacy

05

Is Markdown the database?

No. Wenlan uses a local database and index for retrieval, graph context, pages, and daemon state. Markdown artifacts are the human-readable projection, not the whole storage system.

This gives agents fast retrieval while still giving humans files they can inspect, version, back up, and move.

Read source-backed pages

06

Does uninstall delete memory?

No. wenlan background off stops Wenlan and removes the per-user service registration. It does not delete ~/.wenlan or the daemon data directory.

That separation is intentional because local memory may be the only record of project decisions, handoffs, private preferences, and generated pages.

Read updates and uninstall

07

How do I know it works?

Run /setup in Claude Code or wenlan doctor from the terminal. Then capture one small durable fact and recall it from the client you plan to use.

If daemon health passes and a capture/recall round trip works, the client is connected to the same Wenlan daemon.

Read troubleshooting

Next

Security and Reporting

Report Wenlan vulnerabilities privately, redact diagnostic output, and understand the local daemon security boundary.

Read next