> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gensparx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# completion

# `gensparx completion`

Generate shell completion scripts and optionally install them into your shell profile.

## Usage

```bash theme={null}
gensparx completion
gensparx completion --shell zsh
gensparx completion --install
gensparx completion --shell fish --install
gensparx completion --write-state
gensparx completion --shell bash --write-state
```

## Options

* `-s, --shell <shell>`: shell target (`zsh`, `bash`, `powershell`, `fish`; default: `zsh`)
* `-i, --install`: install completion by adding a source line to your shell profile
* `--write-state`: write completion script(s) to `$GENSPARX_STATE_DIR/completions` without printing to stdout
* `-y, --yes`: skip install confirmation prompts

## Notes

* `--install` writes a small "gensparx Completion" block into your shell profile and points it at the cached script.
* Without `--install` or `--write-state`, the command prints the script to stdout.
* Completion generation eagerly loads command trees so nested subcommands are included.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.