Versioning
Local Git History
Inspect the real git history Wenlan keeps for readable page, session, handoff, and status artifacts.
At a glance
01
Wenlan versions local artifacts with a real git repository under ~/.wenlan/.git.
02
Git history is for inspection, accountability, recovery, and understanding what changed across sessions.
01
What is versioned
Wenlan writes human-facing artifacts under ~/.wenlan, including pages, session handoffs, and current status records. Those artifacts are committed into a local git repository.
The git log gives you a practical audit trail for memory work: what changed, when it changed, and which artifacts were touched.
02
Inspect history
Use normal git commands from ~/.wenlan to inspect recent readable artifact writes and page changes. This is often faster than opening the database when you want to understand a human-readable change.
The repository is local. It is not pushed anywhere unless you explicitly sync or publish it yourself.
Terminal
cd ~/.wenlan
git log --oneline --decorate --all -20
git show --stat HEAD
git diff HEAD~1 -- pages/03
Recover with care
Git can help inspect, diff, revert, or recover a previous Markdown page or session note, but do not treat manual git restore as a full database rollback.
If the durable knowledge is wrong, the safer product path is to capture a correction or forget the memory by ID. That keeps the index and readable artifacts aligned.
04
Use with your notes
Because pages and sessions are normal files, you can inspect them from editors, terminals, or personal note tools. Some users symlink pages into a vault for reading.
Keep writes disciplined. Wenlan should remain the writer for generated artifacts unless you intentionally edit a human-owned page.
Example
ln -s ~/.wenlan/pages ~/Documents/Wenlan-pages05
Privacy boundary
Local git history makes Wenlan more inspectable, but it also means old versions may contain old private context.
Do not publish, sync, or attach ~/.wenlan blindly. Redact or create minimal reproductions when reporting bugs.
Next
Models and Keys
Choose between local memory mode, optional on-device models, and optional Anthropic API keys for richer extraction, page synthesis, recaps, and graph work.
Read next