File and Directory Layout
This page maps where the engine reads and writes on disk. Knowing the layout helps with backups, troubleshooting, and version control.
The engine home directory
Section titled “The engine home directory”$WAYLAND_HOME is the base for the engine’s per-machine data when it is set (it hermetically sandboxes every path the engine touches). The cron store and user agents fall back to ~/.wayland when $WAYLAND_HOME is unset.
| Path | Contents |
|---|---|
$WAYLAND_HOME/logs/wayland-core.log | Trace log written while the full-screen TUI is running. |
$WAYLAND_HOME/cron/jobs.json (else ~/.wayland/cron/jobs.json) | Persisted scheduled jobs. |
$WAYLAND_HOME/cron/history.jsonl (else ~/.wayland/cron/history.jsonl) | Fire history for scheduled jobs. |
$WAYLAND_HOME/evolved/ | Evolved system-prompt variants from online evolution. |
~/.wayland/agents/ (or $WAYLAND_HOME/agents/) | User-defined agent definitions, one TOML file each. |
The global config and skills
Section titled “The global config and skills”The global config file and the user-global skills live in the platform config directory under a wayland-core/ subdirectory. When $WAYLAND_HOME is set it replaces this base; otherwise the engine uses dirs::config_dir() (or $XDG_DATA_HOME) joined with wayland-core/. Run wayland-core --config-path to print the config path and wayland-core --skills-path to print the skill directories on your machine.
| Platform | Config base directory (before the wayland-core/ segment) |
|---|---|
| macOS | ~/Library/Application Support/ |
| Linux | ~/.config/ (or $XDG_CONFIG_HOME / $XDG_DATA_HOME) |
| Windows | C:\Users\<user>\AppData\Roaming\ |
User-global skills sit under <config-dir>/wayland-core/skills/, and the global memory store under <config-dir>/wayland-core/memory/memory.db.
The project directory
Section titled “The project directory”When you run the engine inside a project, it reads and writes a .wayland-core/ directory there. The engine loads .wayland-core.toml from the working directory (override with --project-dir).
| Path | Contents |
|---|---|
.wayland-core.toml | Project-level config that overrides the global file. |
.wayland-core/skills/ | Project-local skills, checked in with the repo. |
.wayland-core/commands/ | Legacy flat skill files (backward compatibility). |
.wayland-core/sessions/ | Saved sessions, only if session.directory is set to this project path. By default sessions live at the per-user <config-dir>/wayland-core/sessions/. |
.wayland-core/plans/ | Plan-mode output (default location). |
.wayland-core/memory/memory.db | Project memory store. |
.wayland/workflows/ | Saved RON ForgeFlows. |
Skill load order
Section titled “Skill load order”When two skills share a name, the first match wins, in this order:
.wayland-core/skills/(project)<config-dir>/wayland-core/skills/(user-global).wayland-core/commands/(legacy)