Detect circular dependencies
Use:
rev-dep circular
This gives cycle-focused output without requiring a config file, which is useful during refactors or before adopting the full config runner. Can be used as a CI check on it's own.
Useful flags
rev-dep circular --ignore-type-imports
rev-dep circular --process-ignored-files 'dist/**/*.generated.ts'
--ignore-type-importsignores type-only edges, so type-level cycles are not reported.
How cycles are detected
Cycle detection uses Strongly Connected Components (SCC). Files that all depend on each other form one group, and the command reports one cycle per group. So a tangle of five files gives you one finding, not every possible path through it.
Exit code
The command exits with the number of cycles found (non-zero when any exist), which makes it suitable for lightweight CI use even without a config file.