That's great!

Could you write down the process to persist those bash modifications within a readme or within the helper of this function?

Would it also be possible to auto-detect which shell is currently used like https://stackoverflow.com/questions/9910966/how-to-get-shell-to-self-detect-using-zsh-or-bash to remove the requirement to manually input it?

I have added more help information which can be seen with dora completions --help
And it will try to autodetect the shell type if the shell type is not given manually now.

I don't think the helper work:

(base) ~/D/w/d/e/rust-dataflow ❯❯❯     echo "eval \$(dora completions bash)" >> .bashrc                                                                              (base)  ✘ 130 cli-autocompletion ✭ ◼
zsh: no such file or directory: .bashrc

Also, you didn't mention about auto detection of shell.

Could you also remove the s of completions as there is at most one auto-completion.

I don't think the helper work:

(base) ~/D/w/d/e/rust-dataflow ❯❯❯     echo "eval \$(dora completions bash)" >> .bashrc                                                                              (base)  ✘ 130 cli-autocompletion ✭ ◼
zsh: no such file or directory: .bashrc

Also, you didn't mention about auto detection of shell.

Sry, it is my fault.
For Zsh, I think it should be echo 'eval "$(dora completion)"' >> ~/.zshrc
The SHELL parameter is wrapped by [ and ] in the help info, which means it is optional.
When the shell is not given, it will try to figure out which shell you are using.

Do you mean write down all the available shell as example in the help info?
Or even implement the config writing process with pipe into the completion command itself automatically?

Could you also remove the s of completions as there is at most one auto-completion.

Fine.

Updated.

Tested on bash, fish and zsh, and the help info has updated as below:

Usage: dora completion [SHELL]

Arguments:
  [SHELL]  The shell to generate the script for [possible values: bash, elvish, fish, powershell, zsh]

Options:
  -h, --help  Print help


USAGE:
  eval $(dora completion)              # Auto-detect shell
  eval $(dora completion <SHELL>)      # Specify shell explicitly

PERSIST COMPLETION:

  Bash:
    echo 'eval "$(dora completion bash)"' >> ~/.bashrc
    # Then restart shell

  Zsh:
    echo 'eval "$(dora completion zsh)"' >> ~/.zshrc
    # Then restart shell

    # If you get 'command not found: compdef', add this before the eval line:
    autoload -Uz compinit
    compinit

  Fish:
    # Add to ~/.config/fish/config.fish
    if status is-interactive
        eval "$(dora completion fish)"
    end
    # Then restart shell

Great! Thanks!