Skip to main content

Overview

Kodus configurations work across three levels: Global, Repository, and Directory.
The most specific level wins: Directory > Repository > Global
Global
 ├─ Repository A
 │   ├─ Directory A1
 │   └─ Directory A2
 └─ Repository B

How It Works

Fields inherit from the parent level by default. When you change a field at Global, all repositories and directories without an override update automatically.
Overrides are per field. You can override one field and inherit everything else.
Once overridden, a field stops following the parent and uses its local value instead.

Examples

  • Global change propagates
  • Repository override
  • Return to inheritance
You change Severity thresholds at Global.All repositories and directories without an override update automatically. Overridden ones stay unchanged.

Best Practices

  • Start at Global with strong defaults
  • Only override when you have a specific need for that repo/directory

Frequently Asked Questions

No. Local overrides stay unchanged.
Yes. Overrides are per field.
From Repository first. If Repository has no override for that field, it inherits from Global.
I