FlowLint CLI

Command-line tool for static analysis of n8n workflows.

Installation

npm install -g flowlint

Or use npx:

npx flowlint scan .

Usage

Scan workflows

# Scan current directory
flowlint scan

# Scan specific directory
flowlint scan ./workflows

# Output as JSON
flowlint scan --format json

# Fail on errors (for CI)
flowlint scan --fail-on-error

Initialize configuration

flowlint init

Creates a .flowlint.yml file in the current directory.

Configuration

Create a .flowlint.yml file:

files:
  include:
    - "**/*.n8n.json"
  ignore:
    - "node_modules/**"

rules:
  rate_limit_retry:
    enabled: true
  error_handling:
    enabled: true
  # ... more rules

Rules

| Rule | Description | Severity | |------|-------------|----------| | R1 | Rate limit retry | must | | R2 | Error handling | must | | R3 | Idempotency | should | | R4 | Secrets exposure | must | | R5 | Dead ends | nit | | R6 | Long running | should | | R7 | Alert/log enforcement | should | | R8 | Unused data | nit | | R9 | Config literals | should | | R10 | Naming convention | nit | | R11 | Deprecated nodes | should | | R12 | Unhandled error path | must | | R13 | Webhook acknowledgment | must | | R14 | Retry-After compliance | should |

License

MIT

Dependencies

This tool depends on @replikanti/flowlint-core for linting logic.