Skip to content

CLI Options

Complete reference for all command-line options.

Print help information for the command.

Terminal window
fsh-lint --help
fsh-lint lint --help

Print version information.

Terminal window
fsh-lint --version
# Output: fsh-lint 0.1.0

Enable verbose logging output.

Terminal window
fsh-lint --verbose lint **/*.fsh

Control color output:

  • auto - Automatic (default)
  • always - Always colorize
  • never - Never colorize
Terminal window
fsh-lint --color always lint **/*.fsh
fsh-lint --color never lint **/*.fsh > output.txt

Automatically apply safe fixes.

Terminal window
fsh-lint lint --fix **/*.fsh

Filter diagnostics by minimum severity:

  • hint
  • info
  • warn
  • error
Terminal window
fsh-lint lint --severity error **/*.fsh

Output format:

  • human - Human-readable (default)
  • json - JSON format
  • sarif - SARIF format
  • github - GitHub Actions annotations
Terminal window
fsh-lint lint --format json **/*.fsh
fsh-lint lint --format github **/*.fsh

Specify configuration file path.

Terminal window
fsh-lint lint --config custom-config.json **/*.fsh

Ignore all configuration files.

Terminal window
fsh-lint lint --no-config **/*.fsh

Limit number of diagnostics shown.

Terminal window
fsh-lint lint --max-diagnostics 50 **/*.fsh

Enable only specific rules.

Terminal window
fsh-lint lint --rule style/naming-convention **/*.fsh
fsh-lint lint --rule correctness/** **/*.fsh

Ignore files matching pattern.

Terminal window
fsh-lint lint --ignore-pattern "**/*.generated.fsh" **/*.fsh

Check formatting without modifying files.

Terminal window
fsh-lint format --check **/*.fsh

Show formatting differences.

Terminal window
fsh-lint format --diff **/*.fsh

Generate full example configuration.

Terminal window
fsh-lint init --full

Specify output path for configuration.

Terminal window
fsh-lint init --output .fshlintrc.json

Show detailed rule information.

Terminal window
fsh-lint rules --detailed

Filter rules by category:

  • style
  • documentation
  • correctness
  • suspicious
Terminal window
fsh-lint rules --category style

Search rules by name or description.

Terminal window
fsh-lint rules --search naming

Override configuration file path.

Terminal window
export FSH_LINT_CONFIG=custom-config.json
fsh-lint lint **/*.fsh

Disable color output.

Terminal window
export FSH_LINT_NO_COLOR=1
fsh-lint lint **/*.fsh

Set cache directory location.

Terminal window
export FSH_LINT_CACHE_DIR=.fsh-lint-cache
fsh-lint lint **/*.fsh