Configuration reference
Every supported field in signalint.config.json, including defaults and validation behavior.
Signalint loads signalint.config.json from the checked project root. The file is optional; omitted fields receive the defaults below. Unknown keys and incorrect types fail with a configuration error.
{
"engines": {
"oxlint": true,
"tsc": true,
"biome": false
},
"ignore": ["node_modules/**", "dist/**", ".signalint/**"],
"timeoutsMs": {
"oxlint": 30000,
"tsc": 120000,
"biome": 30000
}
}Top-level fields
| Field | Type | Default | Meaning |
|---|---|---|---|
engines | object | See below | Enable or disable each built-in engine. |
ignore | string[] | node_modules/**, dist/**, .signalint/** | Project-relative paths removed from requested files and final diagnostics. |
timeoutsMs | object | See below | Positive-integer subprocess deadlines in milliseconds. |
engines
| Field | Type | Default | Behavior |
|---|---|---|---|
oxlint | boolean | true | Runs file-local Oxlint diagnostics. |
tsc | boolean | true | Runs whole-program TypeScript diagnostics from the root tsconfig. |
biome | boolean | false | Runs file-local Biome diagnostics. |
Omitted engine keys keep their individual defaults; they are not coerced to false.
ignore
Each entry must be a non-empty project-relative glob. Signalint supports *, **, and ?, and normalizes Windows path separators. Because tsc is whole-program, it still sees its complete configured program when invoked; matching diagnostics are removed from the response.
A diagnostic whose path contains a node_modules segment is always excluded, regardless of this setting.
timeoutsMs
| Field | Type | Default |
|---|---|---|
oxlint | positive integer | 30,000 ms |
tsc | positive integer | 120,000 ms |
biome | positive integer | 30,000 ms |
On timeout, Signalint terminates that engine's process tree. In a schema 1.1 check response the engine receives { "status": "error", "message": "…" } under engines, while completed engines' diagnostics are preserved.
Engine-native configuration
Keep lint and compiler rules in their native files. The v1 cache hash recognizes root .oxlintrc, .oxlintrc.json, oxlint.json, tsconfig.json, biome.json, and biome.jsonc. Changing one invalidates the related engine cache.
Other valid sources—including .oxlintrc.jsonc, extended configs, and nested package configs—are not part of v1 cache hashing. Clear .signalint/ after changing one of those files.