Concepts
DocumentationLyt keeps your notes as plain files on your machine and makes them something your agent can search. Lyt is a local-first knowledge system: Git-backed markdown is the source of truth; YON declarations and libSQL indexes make that knowledge operable.
The architecture
A Lyt vault is a folder of plain markdown in Git. Its YON declarations describe the vault and its relationships, while libSQL keeps derived, regenerable indexes for search and local operations. Markdown and the declarations remain the durable records; indexes can be rebuilt from them. Build outward from vaults, through meshes, into a pod.
The model, end to end
Identity and addressing keep a vault stable when its display name or home mesh changes. A Figment is the structured markdown note inside it. Search runs a confidence cascade over local indexes and adds matches by meaning through a local semantic model you choose to download once. Sharing and sync are explicit Git-backed operations, not a hidden central store.
Local by default, explicit at the boundary
Local indexing and search operate on the copies on your machine. Sync contacts a configured Git remote, and any external AI adapter is a separately chosen network boundary with its own credentials and policy. Lyt does not turn those choices into an implicit cloud memory service.
Versioning and installation
These pages describe the current Lyt release. Install the unified CLI from npm; its published packages move together on the same release line.
npm install -g @younndai/lyt