Shell Completion for NeoMutt

This repository contains bash completion scripts for NeoMutt and its configure script.

Copyright

Copyright (C) 2026 Richard Russon <rich@flatcap.org>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

See LICENSE.md for the full license text.

Files

• bash/neomutt.bash - Bash completion for the NeoMutt email client
• bash/configure.bash - Bash completion for NeoMutt's autosetup (./configure) script

Installation

System-wide Installation

Copy the completion scripts to your bash completion directory:

sudo cp bash/neomutt.bash /usr/share/bash-completion/completions/neomutt
sudo cp bash/configure.bash /usr/share/bash-completion/completions/configure

User Installation

For a user-specific installation, copy to your local completion directory:

mkdir -p ~/.local/share/bash-completion/completions
cp bash/neomutt.bash ~/.local/share/bash-completion/completions/neomutt
cp bash/configure.bash ~/.local/share/bash-completion/completions/configure

Manual Loading

To use the completions immediately without restarting your shell:

source bash/neomutt.bash
source bash/configure.bash

You can also add these lines to your ~/.bashrc file for automatic loading.

Features

NeoMutt Completion

The neomutt completion script provides intelligent completion for:

• Command-line options (both short and long forms)
• Email addresses from aliases, query commands, and system users
• File paths with NeoMutt shortcuts (=folder, +folder, !spool)
• Configuration options for -Q/--query flag
• Help topics, debug levels, and mailbox types

Configure Completion

The configure completion script provides completion for:

• All configuration flags (--everything, --asan, --gnutls, etc.)
• Options with values (--prefix=, --with-ssl=, etc.)
• Debug options (--debug-logging, --debug-color, etc.)

Requirements

• Bash 4.0 or later
• bash-completion package (provides helper functions)
• NeoMutt (for neomutt.bash to function properly)

Links

• NeoMutt: https://neomutt.org
• Repository: https://github.com/neomutt/shell-completion