Completion Command - Entrenar - Training & Optimization Library
Description: A comprehensive guide to building neural network training systems with autograd, optimizers, LoRA/QLoRA, and quantization using EXTREME TDD methodology

# Completion Command

The `entrenar completion` command generates shell completion scripts for bash, zsh, fish, and PowerShell.

## Usage

    entrenar completion <SHELL>

## Arguments

Argument | Description
--- | ---
`<SHELL>` | Target shell: bash, zsh, fish, powershell

## Installation

### Bash

    # Generate and install completions
    entrenar completion bash > ~/.local/share/bash-completion/completions/entrenar

    # Or for system-wide installation (requires sudo)
    entrenar completion bash | sudo tee /etc/bash_completion.d/entrenar > /dev/null

    # Reload completions
    source ~/.bashrc

### Zsh

    # Generate completions
    entrenar completion zsh > ~/.zsh/completions/_entrenar

    # Add to fpath in ~/.zshrc
    fpath=(~/.zsh/completions $fpath)

    # Rebuild completion cache
    rm -f ~/.zcompdump && compinit

### Fish

    # Generate and install completions
    entrenar completion fish > ~/.config/fish/completions/entrenar.fish

    # Completions are automatically loaded

### PowerShell

    # Generate completions
    entrenar completion powershell | Out-File -Encoding utf8 $PROFILE.CurrentUserAllHosts

    # Or append to existing profile
    entrenar completion powershell | Add-Content $PROFILE

## Completion Features

The generated completions provide:

- Command completion - All subcommands (train, validate, info, etc.)
- Option completion - All flags and options
- File path completion - For file arguments (.yaml, .safetensors, etc.)
- Value completion - For enum options (format, method, etc.)

## Example Usage

After installation, type `entrenar` and press Tab:

    $ entrenar <TAB>
    audit       completion  info        inspect     merge       monitor
    quantize    research    train       validate

    $ entrenar train <TAB>
    config.yaml  examples/    mnist.yaml

    $ entrenar train config.yaml --<TAB>
    --batch-size  --dry-run     --epochs      --help
    --lr          --output-dir  --quiet       --verbose

## Verification

Verify completions are working:

    # Bash
    complete -p entrenar

    # Zsh
    which _entrenar

    # Fish
    complete -c entrenar

## Troubleshooting

### Completions Not Working

1. Check installation path:

       # Bash
       ls ~/.local/share/bash-completion/completions/entrenar

       # Zsh
       echo $fpath | grep completions

2. Reload shell:

       exec $SHELL

3. Regenerate completions:

       entrenar completion bash > /tmp/entrenar.bash
       source /tmp/entrenar.bash

### Permission Issues

    # Use sudo for system-wide installation
    sudo entrenar completion bash > /etc/bash_completion.d/entrenar

## See Also

- CLI Overview - General CLI reference
- Installation - Installation guide