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

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.