Concepts
The ten words you need to read the rest of the docs.
Lorevik uses one name for each idea. These are the names used across the app, the docs, and Explore.
Package#
The unit you install, run, and can list in Explore. A Package is a folder. It holds a Skill for the Agent and, optionally, Pages and Package data. It runs on your computer, with your own Agent.
Page#
The interface a Package renders for people to look at. A Package can have one Page or several. On disk a Page is a single self-contained HTML file, usually service.html.
Skill#
The working instructions a Package gives to the Agent, written in SKILL.md. It is the only required part of a Package. The Skill is what stays stable, reusable, and versioned; the Agent program that carries it out can change at any time.
Package data#
Your own data for one Package. The Agent writes it, the Page displays it, and it stays in your Vault. On disk it is data.json, with an optional data.schema.json that describes its shape.
Vault#
An ordinary folder on your computer that holds all your Packages and their Package data. You can see it in Finder, copy it, and back it up like any other folder. It is not a database and it is not cloud storage.
Routine#
A task that belongs to one Package and runs on a schedule or when something happens, for example refreshing that Package's data at a set time. A Package can have any number of Routines.
Explore#
Where you browse, install, and buy Packages. Explore shows only Packages that have been published.
Studio#
Where a creator runs their own Packages: their works, income, buyers, and publishing. Publishing a Package to Explore happens only here.
Thread#
The one long-running conversation between you and your Agent. It is kept and never deleted. Study, everyday life, and keeping Lorevik running all happen in this one Thread, and the Agent works out which is which.
Agent#
The identity your own local AI has inside Lorevik: a name, Rosie by default, and an avatar. It is an identity, not a particular program. The Agent CLI and model behind it can be swapped at any time, and the Agent carries on with the work in hand without losing its memory.
How they fit together#
A Package is made of one Skill, zero or more Pages, and its Package data. It lives in your Vault and is run by your Agent. A Routine belongs to one Package. Explore shows published Packages; publishing happens only in Studio. You have one Agent and one Thread.