Skip to content

Architecture

Why Wenlan Uses Readable Artifacts plus a Local Store

Wenlan keeps raw captures in a daemon-owned local store and projects readable artifacts, so AI memory stays inspectable and useful.

Qi-Xuan LuUpdated 5 min read

Article packet

01

Concepts

02

People who want AI memory they can inspect and trust

03

5 min read

01

Raw captures live in the daemon-owned local store that powers recall.

02

Readable pages, sessions, and status files are projected under ~/.wenlan for inspection.

03

This split keeps memory useful to agents without making it opaque to humans.

01

The problem with black-box memory

A memory layer can become risky when the only record lives inside a database or model profile that users cannot inspect. If the assistant retrieves stale or wrong context, it is hard to know where the mistake came from.

For long-running work, memory needs to be readable by people and searchable by agents.

02

Readable artifacts are the projection

Wenlan projects pages, session logs, and project status as readable Markdown so people can open them, read them, export them, and reason about them without a special UI.

That does not mean every raw capture is a Markdown file. It means the human-facing artifacts remain inspectable while the daemon keeps the retrieval store authoritative.

03

The daemon store powers recall

Agents still need fast retrieval. Wenlan uses a local daemon store for captures, vector search, full-text search, graph context, provenance, and other metadata that make memories useful during an AI session.

The store is not a cloud black box. It is local application data, and the pages, sessions, and status artifacts give people a readable view into the work loop.

04

Why the split matters

The readable-artifact-plus-local-store design gives both sides what they need: humans get inspection and portability, while agents get retrieval speed and context packaging.

That is the basis for Wenlan's trust story. Memory can be powerful without becoming invisible.

Keep memory readable and searchable

Wenlan pairs readable artifacts with a local retrieval store so memory stays useful to agents and visible to people.

FAQ

Why not store everything only in Markdown?+
Markdown is excellent for human-readable artifacts, but agents need daemon-owned indexes for fast semantic and full-text retrieval. Wenlan uses both.
Why not store everything only in a database?+
A database-only memory layer can become opaque. Wenlan keeps readable artifacts available so people can inspect and correct what AI tools rely on.