---
volume: {{volume}}
distro: {{distro}}
distro-version: {{distro-version}}
created: {{created}}
kernel-source: {{kernel-source}}
distro-source: {{distro-source}}
---

# {{volume}}

Per-volume omne README. **Non-loaded** — Claude Code does not `@import`
this file. The boot chain starts at the top-level `CLAUDE.md`, which
imports `@.omne/dist/AGENTS.md` directly.

## Identity

- **Volume:** {{volume}}
- **Distro:** {{distro}} v{{distro-version}}
- **Created:** {{created}}
- **Kernel source:** {{kernel-source}}
- **Distro source:** {{distro-source}}

## Directory contract

- `.omne/core/` — kernel release, managed by `omne upgrade kernel`
- `.omne/dist/` — distro release (agents, skills, hooks, pipes),
  managed by `omne upgrade distro`
- `.omne/lib/cfg/` — install-time configuration; frozen during runs
- `.omne/lib/docs/` — documentation vault (`raw/`, `inter/`, `wiki/`)
- `.omne/var/` — runtime state; per-run `events.jsonl` + `nodes/`
- `.omne/wt/` — detached git worktrees, one per run

`var/runs/*/events.jsonl` is committed; `var/runs/*/nodes/`, `wt/`,
and `var/.ulid-last` are gitignored (see `.gitignore`).

## Everyday commands

- `omne run <pipe> [--input k=v ...]` — execute a pipe
- `omne status [<run_id>]` — inspect run state
- `omne validate` — check volume integrity
- `omne upgrade [kernel|distro]` — pull the latest release
