Skip to content

Working on a realm

The loop the CLI exists to make short:

Terminal window
embabel realms link ~/dev # once

then, from a coding agent connected over MCP:

install_realm_from_path("realm-esg") # once — by reference, nothing is cloned
… edit the files in ~/dev/realm-esg with your own tools …
realm_validate_path("realm-esg") # would it load?
realm_refresh() # the world re-reads it
kg_query(…) # does it answer?

and git push from the checkout, to your own GitHub. Nothing in that requires the appliance to write to your files, which is why the mount is read-only.

realm_brief over MCP explains the realm format and points at the realm-authoring skill that walks through building one.