| name | lev-onboarding |
| description | First-run setup wizard for Lev — prereqs, XDG scaffolding, config, smoke validation, handoff to /work. |
| triggers | ["install lev","setup lev","first run","onboard agent","lev doctor","prereq check","new machine","fresh install"] |
| source_flow | lev-onboarding.flow.yaml |
| generated | true |
lev-onboarding
First-run setup wizard for Lev — prereqs, XDG scaffolding, config, smoke validation, handoff to /work.
Takes a human or coding-agent from zero to a working Lev install. Absorbs the
hm-01 setup wizard pattern from hermes and the oc-02 onboarding wizard pattern
from openclaw into a single Lev-specific surface, replacing the prior deferrals
that had no valid home under /agent-field-kit's generic remote-access charter.
Quick Start
lev exec --flow lev-onboarding
Source of Truth
- dna/skills/lev-onboarding.intent.yaml
- dna/core/onboarding.dna.yaml
- docs/ARCHITECTURE.md (XDG Directory Map)
Steps
- Run prereq-check: verify git, bun, pnpm, and writable XDG paths
- Install or verify Lev CLI surface via core/poly (idempotent)
- Scaffold XDG dirs: ~/.config/lev, ~/.local/share/lev, ~/.local/state/lev, ~/.cache/lev
- Write default settings.yaml and reactive/hooks.yaml under $XDG_CONFIG_HOME/lev
- Run smoke test: lev doctor plus one canonical flow execution
- Emit lev.onboarding.* LevEvents for each step (visible on event bus)
- Hand off to /work with a pre-filled tracked session for the first piece of real work
Done Condition
- Criteria: lev doctor returns exit 0 AND at least one flow executes end-to-end AND first /work session is tracked
- Metric: prerequisite_check_passes
- Metric: xdg_paths_created
- Metric: default_config_written
- Metric: first_flow_execution_ok
- Metric: first_work_session_tracked