# CRD Navigator

Omni exposes many resource types. `omnipy crd` helps discover and explain them.

## Commands

```bash
omnipy crd list
omnipy crd list --query cluster
omnipy crd show Clusters.omni.sidero.dev
omnipy crd show cluster
omnipy crd explain clusterstatus
```

## Sources and precedence

CRD metadata is resolved using:

1. Curated overrides (`src/omni/models/crd_overrides.py`)
2. Generated catalog (`src/omni/generated/crd_catalog.py`)
3. Runtime fallback (`ResourceDefinitions.meta.cosi.dev`) when needed

## Explain bridge in `get`

You can show CRD context before resource output:

```bash
omnipy get Clusters.omni.sidero.dev my-cluster --explain -o yaml
```
