Skip to content
NextDNS Blocker

completion

The completion command generates shell completion scripts for bash, zsh, and fish shells.

Usage

Section titled “Usage”
Terminal window
nextdns-blocker completion SHELL

Where SHELL is one of: bash, zsh, or fish.

Shells Supported

Section titled “Shells Supported”
ShellCommand
Bashnextdns-blocker completion bash
Zshnextdns-blocker completion zsh
Fishnextdns-blocker completion fish

Installation

Section titled “Installation”

Bash

Section titled “Bash”

Add to your ~/.bashrc:

Terminal window
eval "$(nextdns-blocker completion bash)"

Then reload:

Terminal window
source ~/.bashrc

Zsh

Section titled “Zsh”

Add to your ~/.zshrc:

Terminal window
eval "$(nextdns-blocker completion zsh)"

Then reload:

Terminal window
source ~/.zshrc

Fish

Section titled “Fish”

Save to the completions directory:

Terminal window
nextdns-blocker completion fish > ~/.config/fish/completions/nextdns-blocker.fish

The completions will be available in new Fish sessions.

What Gets Completed

Section titled “What Gets Completed”

Shell completion works for:

  • Commands: nextdns-blocker <TAB> shows all available commands
  • Subcommands: nextdns-blocker config <TAB> shows config subcommands
  • Options: nextdns-blocker config push --<TAB> shows available flags
  • Domains: nextdns-blocker unblock <TAB> shows domains from your blocklist
  • Allowlist: nextdns-blocker disallow <TAB> shows domains from your allowlist

Examples

Section titled “Examples”

Command Completion

Section titled “Command Completion”
Terminal window
$ nextdns-blocker <TAB>
allow           completion      fix             nextdns         pending         status          update
category        config          health          panic           stats           test-notifications  watchdog
disallow        init

Subcommand Completion

Section titled “Subcommand Completion”
Terminal window
$ nextdns-blocker config <TAB>
edit      set       show      push      validate

Option Completion

Section titled “Option Completion”
Terminal window
$ nextdns-blocker config push --<TAB>
--config-dir  --dry-run     --help        --verbose

Domain Completion

Section titled “Domain Completion”
Terminal window
$ nextdns-blocker unblock <TAB>
facebook.com  instagram.com  reddit.com  twitter.com

Automatic Installation

Section titled “Automatic Installation”

The fix command can automatically install completions:

Terminal window
nextdns-blocker fix

This will detect your shell and install completions if not already present.

Troubleshooting

Section titled “Troubleshooting”

Completions Not Working

Section titled “Completions Not Working”
  1. Ensure the eval line is in your shell config file
  2. Open a new terminal or source the config file
  3. Verify the completion is loaded:
    Terminal window
    type _nextdns-blocker  # For bash/zsh

“Command not found” Error

Section titled ““Command not found” Error”

Ensure nextdns-blocker is in your PATH:

Terminal window
which nextdns-blocker

If not found, you may need to add the installation directory to your PATH.

Slow Completion

Section titled “Slow Completion”

Domain completion queries your config file. If you have many domains, there may be a slight delay. This is normal.

Section titled “Related”