Versioning
Local Git History
Inspect the real git history Origin keeps for local memory, page, session, and status artifacts.
At a glance
01
Origin versions local artifacts with a real git repository under ~/.origin/.git.
02
Git history is for inspection, accountability, recovery, and understanding what changed across sessions.
01
What is versioned
Origin writes human-facing artifacts under ~/.origin, 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 ~/.origin to inspect recent memory 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 ~/.origin
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. Origin should remain the writer for generated artifacts unless you intentionally edit a human-owned page.
Example
ln -s ~/.origin/pages ~/Documents/Origin-pages05
Privacy boundary
Local git history makes Origin more inspectable, but it also means old versions may contain old private context.
Do not publish, sync, or attach ~/.origin 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 distill cycles.
Read next