flaglint completion

flaglint completion prints a shell completion script to stdout. Source it once and your shell will tab-complete subcommands, flags, and flag values (format choices, shell names, and more).

Command

flaglint completion <shell>

Supported shells: bash, zsh, fish.

Installation

Bash

Load for the current session only:

source <(flaglint completion bash)

Load permanently (add to ~/.bashrc or ~/.bash_profile):

flaglint completion bash >> ~/.bash_completion

Zsh

Load for the current session only:

source <(flaglint completion zsh)

Load permanently (requires ~/.zsh/completions in your $fpath):

mkdir -p ~/.zsh/completions
flaglint completion zsh > ~/.zsh/completions/_flaglint

Then ensure $fpath includes the directory before compinit runs — add to ~/.zshrc:

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit

Fish

flaglint completion fish > ~/.config/fish/completions/flaglint.fish

Fish auto-sources files in ~/.config/fish/completions/ on startup — no extra configuration needed.

What Gets Completed

Subcommands — audit, scan, migrate, validate, init, completion
Flags — all per-command flags and global flags (--quiet, --verbose)
Flag values — --format values (json, markdown, html, sarif, text), completion shell names (bash, zsh, fish)
File arguments — --output, --config, --baseline, --write-baseline complete against the filesystem

Examples

# Print the bash completion script
flaglint completion bash

# Activate immediately in the current bash session
source <(flaglint completion bash)

# Write the zsh completion script to the standard completions directory
flaglint completion zsh > ~/.zsh/completions/_flaglint

# Write the fish completion file
flaglint completion fish > ~/.config/fish/completions/flaglint.fish

Exit Codes

Code	Meaning
`0`	Script printed successfully.
`2`	No shell argument provided, or unsupported shell name.