138 lines
2.5 KiB
Markdown
138 lines
2.5 KiB
Markdown
# 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
|