Shell Completer

Generate shell completion scripts for CLI tools. Inspired by zeroclaw completions command.

Setup

No dependencies required.

Usage

Generate completions for a tool

{baseDir}/completer.sh my-cli-tool --bash
{baseDir}/completer.sh my-cli-tool --zsh
{baseDir}/completer.sh --fish my-cli-tool

Generate from package.json scripts

{baseDir}/completer.sh --from-package

Auto-detect shell

{baseDir}/completer.sh my-cli-tool

Install completions

{baseDir}/completer.sh my-cli-tool --install

Output

# Generated completions can be:
# 1. Printed to stdout
{baseDir}/completer.sh my-tool

# 2. Saved to file
{baseDir}/completer.sh my-tool --output ~/.completions/_my-tool

# 3. Auto-installed
{baseDir}/completer.sh my-tool --install

Generated Script Example

#!/bin/bash
# Completion for my-cli-tool

_my_cli_tool_complete() {
    local cur prev opts
    COMPREPLY=()
    cur="${COMP_WORDS[COMP_CWORD]}"
    prev="${COMP_WORDS[COMP_CWORD-1]}"
    opts="--help --version --config --verbose --quiet"
    
    if [[ ${cur} == -* ]]; then
        COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
        return 0
    fi
}

complete -F _my_cli_tool_complete my-cli-tool

When to Use

• Adding completions to new CLI tools
• Updating completions after CLI changes
• Setting up new development environments
• Creating completion scripts for custom tools