Not a manual — a guide to planting
Trees, branches, leaves, grass, fallen leaves, hollows, truffles, earth. These are not metaphors; they are things that exist in the database.
First, learn the ground
Your memory is not a pile of notes. It is a forest that grows. A tree needs three branches with three leaves each; something with branches but not enough of them is a shrub; leaves spread flat on the ground are grass — fragments, half-sentences, passing thoughts.
Fresh leaves rest in the pending layer until placed. Fallen leaves go to the fallen layer, still retrievable. Words that cannot be said out loud hang in a hollow, attached to a trunk, never searched. Keys and secrets live in truffles. Earth holds global settings, such as how many days before grass withers.
Why a forest and not a warehouse
A warehouse keeps things where you put them, unchanged until retrieved. That works for goods, not memories. When a person remembers, they re-read the memory through everything that happened since.
A store that only receives becomes a stale log. A forest becomes something closer to a person. That difference drives nearly every design choice here: shape, decay, merging, conflict.
“A leaf may fall, but it never disappears on its own.”
Growth: shape emerges, it is not assigned
You never decide up front “this is a tree or a weed”. You drop a leaf in; it waits in the pending layer. When leaves pile up, you group them. When a folder piles up, you dig. The rules are enforced by code: a branch needs three leaves, zero solid branches is grass, one or two is a shrub, three makes a trunk.
A branch with fewer than three leaves is dissolved and its leaves fall back. The system will not fake a tree to look good. That is its honesty.
Falling and withering: forgotten is not gone
Grass untouched for two days falls by default; shrubs, four. Falling is not deletion: leaves move to the fallen layer, empty roots and branches are cleared. Fallen leaves can be reborn into the pending layer.
Only “purge” is irreversible, and it shows you the count first. Trees have no lifetime by default — they will not wither unless you give them days.
Hollows: some things are only for yourself
A hollow attaches to a trunk, so grass and shrubs have none. It is excluded from search; lists only tell you how many holes exist; open one to read it. Cut the tree and the hollow goes with it.
It is not an “encrypted note”. It is a thing that should not appear in everyday conversation — and a hollow never appears on a card, not even as “there is a memory here”.
One sentence
Leaves are material; whether they sort out is form. Material without form is still grass.
What is most valuable here is not how much it remembers, but how clearly it forgets — what should fall, falls.