Skip to content

app

A graphical app (TS/React) that runs on top of the engine — browser, mail, wallet, agent inbox, etc. Distinct from skill (Python adapters with no UI) and software (third-party apps we connect to).

The engine reads app manifests from configured sources at boot and upserts an app node for each. Apps declare the shapes they render via entity_types and either take over the shell (standalone) or nest inside another app (standalone: false).

MetadataValue
Pluralapps
Subtitle fielddescription
Identityid
FieldType
idstring
app_idstring
standaloneboolean
descriptionstring
entity_typesjson

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

  • Desktop Entry Specification (freedesktop.org) — Apps mirror .desktop entries — a user-facing name, a description, and metadata about what categories/file-types the app handles. Our entity_types plays the role of MimeType.