Local control
Data and Privacy
Where Wenlan keeps data, what stays local, and how readable artifacts work with the daemon-owned retrieval store.
At a glance
01
Wenlan is local-first: the memory layer is owned by the daemon on your machine.
02
Markdown artifacts remain readable while the database stores retrieval indexes and metadata.
01
Local-first by default
Wenlan is designed so the durable context your agents use lives locally first. That context can include project decisions, private constraints, preferences, and work history.
There is no cloud sync or telemetry by default. Connected AI tools may still send prompts to their own model providers; Wenlan's job is to keep the memory layer itself local, inspectable, and shared across tools.
02
Where data lives
Wenlan exposes human-facing artifacts under ~/.wenlan. The daemon database lives under the operating system's application data directory and is linked from ~/.wenlan/db for convenience.
The important files are readable without a special app: pages are Markdown, session logs are Markdown, and project status is stored beside the session records.
- ~/.wenlan/pages/: distilled wiki pages.
- ~/.wenlan/sessions/: session handoff logs.
- ~/.wenlan/sessions/_status/: current project status records.
- ~/.wenlan/bin/: installed Wenlan CLI, daemon, and MCP connector binaries.
- ~/.wenlan/db/: link to the daemon's local database store.
- macOS: ~/Library/Application Support/wenlan/.
- Linux: ~/.local/share/wenlan/ or $XDG_DATA_HOME/wenlan/.
- Windows: %LOCALAPPDATA%\origin\ (current runtime legacy directory).
03
Readable artifacts and retrieval
Raw captures and recall live in the daemon-owned store. Pages, session logs, and project status are readable Markdown projections under ~/.wenlan.
This keeps search fast and structured while giving people inspectable artifacts for pages, handoffs, and status without pretending every memory is a Markdown file.
04
Local memory setup
Wenlan stores, embeds, deduplicates, and serves hybrid search without requiring a local model download or Anthropic API key.
ANTHROPIC_API_KEY is only used when you explicitly opt into daemon-side Anthropic work with the key setup path. Optional model and API paths can add heavier language features, but they are not required for the basic memory loop.
05
Correction and deletion
If a memory is wrong, capture the correction with why it supersedes the old fact. If a memory should be removed entirely, use /forget with the memory ID.
Delete and forget operations are separate from service uninstall. For distilled pages, inspect the Markdown directly. User-edited pages are treated carefully so automated distillation does not overwrite human work casually.
Next
Backup and Migration
Back up Wenlan's readable artifacts and daemon data together, then verify the restored runtime before trusting recall.
Read next