Installation

Requirements

• Python 3.11 or higher
• pip or uv

Install with pip

pip install behave-lint

Install with uv

uv add behave-lint

Optional: watch mode

Watch mode requires the watchdog package. Install it as an optional dependency:

pip install behave-lint[watch]

Or with uv:

uv add 'behave-lint[watch]'

Optional: LSP server

The LSP server provides real-time diagnostics in VS Code, Neovim, and other LSP-compatible editors. Install with:

pip install behave-lint[lsp]

Or with uv:

uv add 'behave-lint[lsp]'

See the LSP Server guide for editor configuration.

Verify installation

behave-lint --version

Next steps

• Quick Start — lint your first feature files
• CLI Reference — all command-line options
• Configuration — customize rule behavior