User Guide

Everything you need to use Liefwork for Obsidian, in the order you will need it.

Liefwork renders a folder of your vault as a coral: every folder a branch, every file a lief, growing oldest to newest. Nothing is copied or converted — a coral is your vault, drawn differently. Anything you do in one shows up immediately in the other.

Four words cover everything, and this guide uses them throughout:

Coral — a folder-tree rendered as one living, growing structure.

Branch — a folder. Sub-folders are sub-branches.

Lief — a note, drawn as a node along its branch: Liefwork's word for a leaf. "Lief" and "note" name the same file — a note in the vault is a lief on the coral.

Meristem — a branch's named growing tip, where new liefs appear; in a plant, the tissue where growth happens. A branch can carry a meristem note — its folder note — holding the branch's own summary.

Start here:

Opening a Coral — installing, and getting your first coral on screen.

Moving Around — panning, zooming, and how labels reveal themselves as you go.

Reading & Writing — opening notes, adding liefs, and growing a branch.

Display Settings — what to show, how big, and how much to emphasise.

Then the deeper water:

Memory Corals — turning a folder into a place an agent can work and remember.

Agent Terminals — running agents from a branch, colour-coded to where they are.

And two you will want eventually:

What Liefwork Writes to Your Vault — exactly what changes on disk, and when.

Limits & Large Vaults — what (+8) means on a big coral, and what to do about it.

Questions this guide doesn't answer are probably in the FAQ.