File system layout

Kleinia follows the Fedora Atomic layout. See An image-based system for why.

Path	Contents	Writable	Kept across updates
/usr	The operating system image	No	Replaced by the new image
/etc	System configuration	Yes	Yes, your changes are merged into the new image’s defaults
/var	System state: logs, containers, Flatpak apps, service data	Yes	Yes
/home → /var/home	User files	Yes	Yes
/opt → /var/opt	Third-party software installed outside packages	Yes	Yes
/agent	Every agent on the system, as a read-only view	No	Generated at runtime
/run	Runtime state	Yes	Cleared on every boot

Inside /agent

/agent/local/            agents on this machine
/agent/local/app/…       applications
/agent/local/system/…    system services and system agents

The path mirrors the agent’s agent:// address: /agent/local/app/libreoffice is agent://local/app/libreoffice. See anything, anywhere, all as agent.

Your data

Agent context and memory, execution traces and model-gateway usage records are kept under /var and your home directory. They stay on this machine unless you send them somewhere. See Privacy.