Configuration reference

Mago's linter is configured in your mago.toml file under the [linter] and [linter.rules] tables.

# Example linter configuration
[linter]
integrations = ["symfony", "phpunit"]
excludes = ["src/Generated/"]
baseline = "linter-baseline.toml"

[linter.rules]
# Disable a rule completely
ambiguous-function-call = { enabled = false }

# Change a rule's severity level
no-else-clause = { level = "warning" }

# Configure a rule's specific options
cyclomatic-complexity = { threshold = 20 }

[linter]

Option	Type	Default	Description
excludes	string[]	[]	A list of paths or glob patterns to exclude from linting.
integrations	string[]	[]	A list of framework integrations to enable (e.g., "symfony", "laravel").
baseline	string	null	Path to a baseline file to ignore listed issues. When specified, the linter will use this file as the default baseline, eliminating the need to pass --baseline on every run. Command-line --baseline arguments will override this setting.
baseline-variant	string	"loose"	The baseline format variant to use when generating new baselines. Options: "loose" (count-based, resilient to line changes) or "strict" (exact line matching). See Baseline Variants for details.

Tool-Specific Excludes

The excludes option here is additive to the global source.excludes defined in the [source] section of your configuration. Files excluded globally will always be excluded from linting, and this option allows you to exclude additional files from the linter specifically.

For example:

[source]
excludes = ["cache/**"]  # Excluded from ALL tools

[linter]
excludes = ["database/migrations/**"]  # Additionally excluded from linter only

[linter.rules]

This table allows you to configure individual lint rules. Each key is the rule's code (in kebab-case).

Common rule options

All rules accept two common options:

• enabled: A boolean (true or false) to enable or disable the rule.
• level: A string to set the issue severity. Options are "error", "warning", "help", and "note".

Rule-specific options

Some rules have additional configuration options. For example, cyclomatic-complexity has a threshold:

[linter.rules]
cyclomatic-complexity = { level = "error", threshold = 15 }

To find the specific options available for any rule, the best and most up-to-date method is to use the --explain command:

mago lint --explain cyclomatic-complexity