Initial commit

commands/completion.md

@@ -0,0 +1,137 @@
+# Completion Command
+
+Generate shell completion scripts for bash, zsh, or fish shells.
+
+## Usage
+
+```bash
+gemini-nano-banana-tool completion SHELL
+```
+
+## Arguments
+
+- `SHELL` - Shell type (bash, zsh, or fish)
+
+## Examples
+
+### Bash Completion
+
+```bash
+# Generate completion script
+gemini-nano-banana-tool completion bash
+
+# Add to ~/.bashrc
+eval "$(gemini-nano-banana-tool completion bash)"
+```
+
+### Zsh Completion
+
+```bash
+# Generate completion script
+gemini-nano-banana-tool completion zsh
+
+# Add to ~/.zshrc
+eval "$(gemini-nano-banana-tool completion zsh)"
+```
+
+### Fish Completion
+
+```bash
+# Generate completion script
+gemini-nano-banana-tool completion fish
+
+# Save to completions directory
+gemini-nano-banana-tool completion fish > \
+  ~/.config/fish/completions/gemini-nano-banana-tool.fish
+```
+
+## What Shell Completion Does
+
+Shell completion provides:
+
+- **Command Completion**: Tab to complete command names
+- **Argument Completion**: Tab to complete option names
+- **Value Completion**: Tab to complete option values (file paths, choices)
+- **Help Integration**: Shows available options while typing
+
+## Installation
+
+### Bash
+
+Add to `~/.bashrc`:
+
+```bash
+eval "$(gemini-nano-banana-tool completion bash)"
+```
+
+Then reload:
+```bash
+source ~/.bashrc
+```
+
+### Zsh
+
+Add to `~/.zshrc`:
+
+```bash
+eval "$(gemini-nano-banana-tool completion zsh)"
+```
+
+Then reload:
+```bash
+source ~/.zshrc
+```
+
+### Fish
+
+Save to completions directory:
+
+```bash
+gemini-nano-banana-tool completion fish > \
+  ~/.config/fish/completions/gemini-nano-banana-tool.fish
+```
+
+Then reload (automatic in most cases):
+```bash
+exec fish
+```
+
+## Verification
+
+Test completion by typing:
+
+```bash
+gemini-nano-banana-tool <TAB>
+```
+
+You should see available commands:
+- `completion`
+- `generate`
+- `generate-conversation`
+- `list-aspect-ratios`
+- `list-models`
+- `promptgen`
+
+## Troubleshooting
+
+If completion doesn't work:
+
+1. **Check Installation**: Verify completion script is loaded
+2. **Reload Shell**: Close and reopen terminal or source config file
+3. **Check Permissions**: Ensure completion file is readable
+4. **Check Path**: Verify `gemini-nano-banana-tool` is in PATH
+
+## Pattern
+
+This follows the industry-standard pattern used by:
+- `kubectl completion`
+- `helm completion`
+- `docker completion`
+- `gh completion`
+
+## Benefits
+
+- **Faster Typing**: Tab completion reduces typing
+- **Discover Options**: See available options without `--help`
+- **Reduce Errors**: Autocomplete prevents typos
+- **Better UX**: Professional CLI experience