Skip to main content
Version: 3.x

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-imports ignores 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.